Takuto CLI リファレンス

Takuto CLI は Takuto Core のコンパニオンツールです: 設定ファイルを 生成し、Docker Compose を取り回し、認証フローを実行します。MIT ライセンスで、手作業で 動かすのと同じエンジンをラップしています。

インストール

Homebrew（macOS / Linux — 推奨）:

brew install takuto-team/tap/takuto

バイナリの手動ダウンロード。 プラットフォーム向けのバイナリを Releases ページ から取得します:

# macOS (Apple Silicon)
curl -L -o takuto https://github.com/takuto-team/takuto-cli/releases/latest/download/takuto-darwin-arm64
chmod +x takuto && sudo mv takuto /usr/local/bin/

# macOS (Intel) — takuto-darwin-amd64
# Linux (amd64)  — takuto-linux-amd64
# Linux (arm64)  — takuto-linux-arm64

Windows では takuto-windows-amd64.exe をダウンロードし、PATH に追加してください。

CLI には Docker または Podman のインストールが必要です — エイリアスを含め、 どちらがあるかを自動検出します。

コマンド

CLI には 5 つのサブコマンドがあります。

takuto setup

対話式のセットアップウィザードを実行します。いまや設定のほとんどはダッシュボードにあるため、 ウィザードは短く済みます — 尋ねられるのは ダッシュボードのポート と、外部データベース （Postgres / MySQL / MariaDB）を使う場合はその 接続情報 だけです（使わなければ組み込みの SQLite がデフォルトになります）。takuto.yml と、config.toml、takuto.env、3 つのスターター workflow 定義を含む workflows/ フォルダーを備えた .takuto/ ディレクトリを生成します。 これらのファイルは カレントディレクトリ に作られます — プロジェクトフォルダーである必要は なく、別々のディレクトリで setup を実行すれば、隔離された Takuto インスタンスを並べて 保てます。

takuto setup
my-project/
  takuto.yml                  # Docker Compose のオーケストレーション
  .takuto/
    config.toml                # プロジェクト設定
    takuto.env                # シークレットと API トークン
    workflows/                 # パイプラインのステップ定義
      implement_ticket.toml
      merge_base.toml
      address_pr_comments.toml

takuto auth

任意 — 非推奨。 container 内で対話式の OAuth ログインフローを実行します:

  1. GitHub CLI（gh）— ブランチの push と PR の作成のため。
  2. あなたの AI プロバイダー — Claude Code、Cursor Agent、Codex、または OpenCode （セルフホスト）。
  3. リポジトリの clone — プロジェクトを container のワークスペースに clone します。

OAuth は広範なアカウントアクセスを与えるため、推奨される道は代わりに 範囲を絞った API キー/トークン です: プロバイダーの認証情報（例: ANTHROPIC_API_KEY、CURSOR_API_KEY、 OPENAI_API_KEY）と範囲を絞った GH_TOKEN を .takuto/takuto.env に設定するか、ダッシュボード から入力してください — 一覧は 設定 を参照してください。対話式の ログインフローがどうしても必要な場合にだけ takuto auth を使ってください。

takuto start

Takuto Core のサービスとダッシュボードを起動します。

takuto start

http://localhost:8080 を開きます。初回起動時、最初の admin アカウントを作成してください。 Jira または GitHub Issues が設定されていればポーリングが自動で始まります。そうでなければ + をクリックして workflow を手動で開始します。

takuto stop

takuto stop

Takuto のサービスを停止します（docker compose down）。認証状態、workflow の スナップショット、キャッシュは名前付きの Docker ボリュームに残ります。

takuto restart

takuto restart

サービスを再起動します。一時停止中や進行中の workflow は保存された状態から再開します。

マルチプロジェクトの隔離

Docker Compose はすべてのボリュームにディレクトリ名をプレフィックスとして付けます （例: my-app_claude-auth、my-app_workspace）。複数のプロジェクトで Takuto を 同時に動かすには、プロジェクトごとに別のディレクトリを使ってください — それぞれが追加設定なしで 完全に隔離された認証、ワークスペース、キャッシュを得ます。

サンプルプリセット

Takuto リポジトリ には、ウィザードを一から実行する 代わりにコピーできる、自己完結したプリセットが同梱されています:

プリセットスタック実行コマンド
react-viteReact + ViteDev Server、Storybook、Preview Build
ruby-railsRuby on RailsRails Server、Console、Sidekiq
rustRustRun Server、cargo watch テスト

各プリセットには、調整済みのインストールコマンド、ダッシュボードに結びついた実行コマンド、 そして妥当な mise/ポートのデフォルトが含まれます。フォルダーをコピーし、config.toml （← でマークされた値 — リポジトリ URL、ブランチ、チケット管理システム）を編集して、 いつものように起動します:

cp -r examples/react-vite/ my-project && cd my-project
# .takuto/config.toml を編集
docker compose -f takuto.yml run --rm -it takuto setup
docker compose -f takuto.yml up -d

プリセットの注意点:

  • react-vite — npm ci でインストール。Vite（5173）と Storybook（6006）への 動的ポートフォワーディング。
  • ruby-rails — bundle install。Ruby 3.3 は初回のエディター起動時に mise 経由で 自動インストールされます（.ruby-version / .tool-versions があればそれに従います）。 Rails サーバーは 0.0.0.0 にバインドするのでポートフォワーディングが機能します。 データベースのホストを [network] extra_egress_hosts に追加してください。
  • rust — cargo build。Rust ツールチェーンはすでにイメージに焼き込まれています。

手動セットアップ（CLI なし）

CLI を使いたくない場合は、プリセットをコピーして Compose を直接実行してください — Takuto README の Manual Setup セクション、 またはソースからエンジンを動かす Takuto Core のインストール ページを 参照してください。