チュートリアル 1: 最初のプロジェクト
コア ループ: プロジェクトの作成 → エージェント セッションの起動 → アタッチ → 作業 → デタッチ。
1. TUI でプロジェクトを作成します。
ccmux を開きます:
ccmux
を押します 2 プロジェクト画面に移動し、 n 新しいプロジェクト フォームを開きます。
以下を入力してください:
- 名前 — プロジェクト ディレクトリ名 (例:
api-service) - ホスト — どのマシンで実行するか (デフォルトはローカル)
- エージェント — Claude、Codex、Antigravity、Cursor、pi、または Grok。使う
←/→をサイクルする
を押します Enter ディレクトリを作成し、セッションを起動します。 ccmux はホーム画面に戻り、新しいセッションがすぐに表示されます。
CLI のショートカット。 コマンドラインを使用したい場合:
ccmux new api-service同じ結果 — ディレクトリが以下に作成されました
projects.root、tmux セッションがデフォルトのエージェント (またはに保存されているエージェント) で開始されました。<project>/.ccmux/agent).
2. セッションに接続します
ホーム画面で、次のセッションに移動します。 j / k を選択し、次のキーを押します: Enter を添付します。
あなたは現在、エージェントを実行している tmux セッション内にいます。完了したら:
Ctrl-b d— 切り離します。 ccmux TUI は自動的に再開します- セッションはバックグラウンドで実行され続けます
3. アタッチせずにステータスを確認する
エージェントを中断せずに、ダッシュボードからセッションの状態を読み取ることができます。の needs_input インジケーター (赤) が注目すべきものです。これは、エージェントが応答を待っていることを意味します。
シェルからセッションをリストするには:
ccmux list
4. プロジェクトのメモ
を押します 4 を TUI で押して開きます: ノート このプロジェクトのタブ。毎 .md プロジェクト ツリー内のファイルは、フォルダー グループ化されたリストに表示されます。 1 つを選択すると、Glamour でレンダリングされます。
を押します / ripgrep を使用してすべてのノートを検索します。
接続を解除すると、ホストが起動している間、セッションは tmux で実行されたままになります。デフォルトの macOS スリープ保護は AC 電源で動作し、蓋を閉じたスリープをオーバーライドしません。を確認してください スリープ設定 ラップトップを放置する前に。
ccmux の改善にご協力ください
不具合、わかりにくい説明、不自然な翻訳を見つけましたか?小さな改善も歓迎します。Issue やプルリクエストでお知らせください。
エラーまたは古いものを見つけましたか? GitHub でこのページを編集します.
