Redline icon

Redline

RedlineはClaude Code向けの予算管理ツール。時間・トークン・コスト・プラン割合の上限内でセッションを調整し、自然な終了を支援します。

Redline

概要

Redlineは、Claude Code向けの予算管理ツールです。アクティブなセッション内で、時間、トークン使用量、コスト、またはプラン割合の上限を設定できます。Claude Code自身のhooksとstatuslineを使用するため、セッションは上限で突然終了するのではなく、そこに向かって自然にペースを調整できます。

このプロジェクトは、予算の終わりでも作業を使える状態に保つことを目的としています。完了済みの結果で終えることを目指し、ハード制限に達する前に新しいツール呼び出しをブロックするための予約ゾーンを使い、サブエージェントのアクティビティも同じセッション予算に含めます。リポジトリでは、Redlineは現時点でClaude Code向けに動作し、Codexやその他のエージェントはロードマップ項目として記載されています。

主要機能

セッション内での予算設定

/redline 10m $5、/redline 1h 200k、/redline 45m 10% のようなコマンドを使って、Claude Code内からセッション予算を設定できます。

ライブstatuslineフィードバック

statusline にライブの消費状況を表示し、セッション実行中に残り時間、コスト、またはプランの余裕を確認できます。

予約ベースのペーシングと制御

ハード停止を待つのではなく、予算に向けてエージェントを調整し、上限に達する前に新しいツール呼び出しをブロックする予約ゾーンを備えています。

セッション全体を対象にした予算管理

生成されたサブエージェントも含めてClaude Codeセッション全体を1つの予算として扱うため、サブエージェントごとの個別制限は不要です。

ローカル制御コマンド

アクティブな予算の確認、landed-rate の確認、バージョン情報の表示、または統合の削除を行うローカルコマンドを提供します。

複数のインストールと削除の方法

Homebrew、curl スクリプト、または git clone のワークフローでインストールでき、後から redline uninstall で削除できます。

主な使用例

  • アクティブなコーディングセッションの予算管理

    モデルに固定した時間、費用、またはトークン量に向けて作業をペース配分してほしいときに、Claude Codeセッションの上限を設定します。

  • 使える形で終えるための余裕確保

    終了時に十分な予算を確保して、長いタスクが突然終わってしまうのを防ぎ、まとめと最終応答の余地を残します。

  • 複数のサブエージェントを1つの予算で管理

    子タスクごとに別々の予算を割り当てることなく、サブエージェントを生成するセッションを管理します。

  • ローカルでの予算パフォーマンス確認

    複数のアクティブなセッションを監視し、ローカルの pulse コマンドで予算内に収まったかどうかを確認します。

  • 統合の追加と削除

    Claude Codeのセットアップにこのツールを導入し、statuslineとhooksの統合が不要になったら後で削除します。

Pros and Cons

Pros

  • 時間、ドルコスト、トークン数、プラン割合など、複数の予算タイプをサポートします。
  • 別個のラッパーやデーモンではなく、Claude Codeのネイティブなhooksとstatuslineを使用します。
  • セッション中に予算の残り余裕を確認できるライブの消費状況ビューを提供します。
  • 生成されたサブエージェントを含め、セッション全体に1つの予算を適用します。
  • 複数のインストール方法を提供し、後からアンインストールできます。

Cons

  • 壁時計時間による強制は厳密ではなくベストエフォートです。設計メモでは、ツール試行やターン境界の間に時間が経過する可能性があるとされています。
  • READMEではRedlineは現在Claude Codeで動作するとされていますが、Codexやその他のエージェントはまだロードマップ上です。
  • このプロジェクトはClaude Codeに付属するNodeランタイムに依存するため、セットアップはその環境に結び付いています。

FAQ

Redlineは何に対応していますか?

RedlineはClaude Code向けに作られており、別のプロセスラッパーやデーモンではなく、Claude Codeのネイティブなhooksとstatuslineを使用します。

どのようにインストールしますか?

READMEには、Homebrew、curlベースのインストールスクリプト、またはリポジトリをクローンしてinstall.shを実行する方法が示されています。

予算はどのように設定または解除しますか?

/redline 10m $5、/redline 1h 200k、/redline 45m 10%、または /redline off のようなコマンドで予算を設定または解除できます。

すべての予算次元は同じ方法で強制されますか?

アーキテクチャの説明では、トークン、コスト、プラン割合の制限は正確に測定されますが、壁時計時間はツール試行時やターン境界で強制されるためベストエフォートです。

Quick Facts

カテゴリ
開発者向けツール
主な用途
Claude Code向けのトークンおよび時間の予算管理
プラットフォーム
Claude Code
ランタイム
Claude Codeに付属するNodeランタイム
ソースドメイン
github.com
ライセンス
MIT