Skip to content

docs: add ceeker architecture/design proposal#7336

Merged
boxp merged 4 commits intomainfrom
T-20260303-002-ceeker-design
Mar 3, 2026
Merged

docs: add ceeker architecture/design proposal#7336
boxp merged 4 commits intomainfrom
T-20260303-002-ceeker-design

Conversation

@boxp
Copy link
Owner

@boxp boxp commented Mar 3, 2026

ceeker design document for Linux/WSL AI coding agent session monitoring TUI. Based on cmux investigation. Codex review passed.


```toml
[hooks]
notify = "curl -s -X POST http://127.0.0.1:9820/hook/notification -H 'Content-Type: application/json' -d '{\"type\": \"notification\", \"message\": \"$MESSAGE\"}'"
Copy link
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

どちらかといえばcodexの方が使う機会が多いので、codexはファーストスコープから入れて欲しい


### 1.1 課題

現在のopenclaw運用環境では、複数のAIコーディングエージェント(Claude Code / Codex)が並行して動作する。各エージェントはgwq worktree上で独立したtmuxセッションとして起動されるが、以下の課題がある:
Copy link
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

openclaw環境での利用は想定しておらず、私のラップトップでの環境(ghq+gwq worktree+tmux)を想定しています


Claude Code / Codex からのhookイベントを受信するHTTPサーバー。

- **リッスンアドレス**: `127.0.0.1:<port>`(localhost限定)
Copy link
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

cmuxのようにブラウザベースの実装は存在しないので、http serverで受けずにhookからコマンド呼び出しさせて受ければ良くないですか?

- Target environment: laptop (ghq+gwq+tmux) instead of openclaw

- Codex integration: included in MVP scope (Phase 1) instead of deferred

- Hook architecture: CLI subcommand + Unix Domain Socket instead of HTTP server

- Project structure: add AGENTS.md as CLAUDE.md symlink for Codex support

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@boxp
Copy link
Owner Author

boxp commented Mar 3, 2026

Review feedback addressed in 18ecfd6. Changes: Codex in MVP scope, laptop env instead of openclaw, UDS+CLI instead of HTTP server, AGENTS.md symlink added.

- `ceeker hook notification` — 通知(進捗、質問、エラー等)
- `ceeker hook stop` — セッション終了通知
- **IPC**: Unix Domain Socket(`$XDG_RUNTIME_DIR/ceeker.sock` or `/tmp/ceeker-<uid>.sock`)
- **フロー**: hook → `ceeker hook <event>` CLI → UDS送信 → TUIプロセスが受信・State Store更新
Copy link
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

これだとTUIが複数起動していたり起動していない状態だと破綻するので ceeker hook <event> 時に ceeker hook <event> 自身がstate storeを更新し、tuiはあくまでstate storeを見るだけにしませんか

Addresses review comment about TUI scenarios. TUI becomes read-only.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@boxp
Copy link
Owner Author

boxp commented Mar 3, 2026

Review feedback addressed in b7b31d2. Hook CLI now directly updates persistent State Store. TUI is read-only client. UDS IPC removed.

@boxp boxp merged commit d27250f into main Mar 3, 2026
14 checks passed
@boxp boxp deleted the T-20260303-002-ceeker-design branch March 3, 2026 11:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant