cliclaw is an open-source CLI agent harness and orchestrator developed by Younggi Choi. Built with TypeScript and targeted at runtimes like Bun and Node.js, the system coordinates multiple AI agents and background task execution while bridging local terminal operations with remote messaging interfaces like Telegram. In daily use, cliclaw acts as a background runner and dispatcher through its internal JobRegistry. Users can manage, trigger, and inspect agent tasks either through local CLI commands or remotely via Telegram chat endpoints. The harness tracks active sessions, monitors process health (memory RSS, heap allocation, in-flight jobs), and manages conversational state persistence. What distinguishes cliclaw from standard single-agent CLIs is its multi-agent orchestration architecture coupled with remote operational control. It incorporates safety confirmation gates to review actions before execution, instance locking to prevent duplicate processes, graceful agent failovers, and structured logging via audit.jsonl and bot.log files. cliclaw is open-source software distributed on GitHub and distributed as an npm package (@younggichoi/cliclaw) ready for deployment via Bun or Node.
Tags: agent harness, cli, coding agent, developer tools, OpenSource
/health and /status. - Safety Confirmation Gates — Intercepts sensitive actions with an interactive approval gate before tasks execute. - Runtime Health & Resource Telemetry — Reports process uptime, memory consumption (RSS/heap), active chat counts, and in-flight jobs. - Structured Audit Logging — Writes execution events and errors to structured logs (audit.jsonl, bot.log, bot.err) for traceability. - Instance Locking — Employs process locking mechanisms to prevent concurrent runner conflicts on the host./health to quickly identify memory bloat, active versus total agent availability, and job queue status across the daemon.cliclaw is designed for developers, systems engineers, and DevOps practitioners who want to orchestrate, monitor, and gate multi-agent AI workflows remotely across servers. It is not suitable for users seeking a simple in-editor inline code autocompletion extension.
bash bun add -g @younggichoi/cliclaw # or npm install -g @younggichoi/cliclaw.env configuration file: bash export TELEGRAM_BOT_TOKEN="your-telegram-bot-token" export TELEGRAM_ALLOWED_USERS="your_user_id" Initialize and start the cliclaw daemon: bash cliclaw startbash # Verify version cliclaw --version # In Telegram chat with the bot: /status /healthPart of CLI Coding Agents
Categories: AI Coding Agents, Code Assistants, Developer Tools