echo-cli-agent

Local CLI bridge agent. Connects coding CLI tools (Codex, Claude Code, Kiro) to your workspace.

Install

npm install -g echo-cli-agent

Requires Node.js ≥ 20.

Usage

# Check local environment
echo-cli-agent doctor

# Print the shared local CLI detection snapshot
echo-cli-agent detect

# Register this device
echo-cli-agent enroll --server <server-url>/api/v1 --code <pairing-code>

# Start the agent
echo-cli-agent run

System Service

# Register as a background service (launchd on macOS, systemd on Linux)
echo-cli-agent service:install

# Remove the service
echo-cli-agent service:uninstall

Update

On a Mini or Linux server that does not use the desktop client, run:

echo-cli-agent update

The command installs the latest npm package and restarts the configured background service. For an Agent version that predates the update command, use this compatible one-line command once:

npm install -g echo-cli-agent@latest && echo-cli-agent service:install

If the Agent uses a non-default config file, run:

echo-cli-agent update --config /absolute/path/config.json

Publish

From the repository root, run:

./publish-latest.sh

The script checks for Node.js 20 or newer, then securely prompts for an npm token, builds the package, automatically increments the patch version when the local version is not newer than npm, and publishes to the public npm registry. The token is only written to a temporary private file during publishing and is removed immediately afterward.

If node is not your Node.js 20+ executable, provide one explicitly:

NODE_BIN=/path/to/node-20-or-newer ./publish-latest.sh

License

MIT