Agent Knock Knock

Agent Knock Knock (AKK)

[](https://www.npmjs.com/package/@scotthuang/agent-knock-knock) [](https://nodejs.org/) [](https://github.com/scotthuang/agent-knock-knock/blob/main/LICENSE)

Most agent orchestrators bring Codex or Claude Code into their own interface. AKK does the reverse: it brings a controller Host into the live tmux or Herdr terminal where you already work. OpenClaw has the bundled native integration; compatible third-party Hosts can use the foreground MCP/stdio Host Bridge and a declarative Profile without forking AKK. Human and agent share the same native session, so either can take over at any time without leaving the other on a forked context.

**Stay in the terminal. Stay in control. No hooks. No agent-side plugins. No YOLO.**

Quick Start with ClawHub

AKK reuses Codex or Claude Code already running in tmux or a supported Herdr session; it never launches a coding agent. You need OpenClaw `2026.6.5`+, a supported terminal host, and an authenticated `codex` or `claude` CLI, all running as the same OS user.

Install AKK and restart the Gateway:

openclaw plugins install clawhub:@scotthuang/agent-knock-knock
openclaw gateway restart

Start the shared coding-agent terminal from the project you want it to work on:

cd /absolute/path/to/project
tmux new-session -s akk-work -c "$(pwd -P)" codex

Use `claude` instead of `codex` if preferred. Wait for the coding agent's idle prompt, then detach from tmux with `Ctrl-b`, followed by `d`.

Herdr `0.8.0` is also supported as an exact-version local terminal provider. See [Quick Start with Herdr](docs/quickstart-herdr.md).

From any configured OpenClaw channel, first send:

/akk doctor

After doctor reports `AKK doctor: ready`, send a separate message:

/akk inspect