quillwire (CLI)

QuillWire's official command-line interface and coding agent. One Node binary that talks to a QuillWire server, runs an interactive coding agent, listens to QuillWire DMs / Telegram / incoming webhooks, and can install itself as an OS-level service.

Install

npm i -g quillwire
quillwire whoami

Or run without installing:

npx quillwire whoami

Requires Node.js 20 or newer. By default the CLI talks to https://quillwire.com; override with --server <url> or the QUILLWIRE_SERVER env var.

Authentication

quillwire login                      # interactive — generates a token bound to this CLI
quillwire whoami                     # confirm the token resolved

Tokens are read in this order:

1. --token flag.
2. QUILLWIRE_TOKEN environment variable.
3. ~/.quillwire.env (also read by the OS service installer).

Common commands

quillwire channels list
quillwire messages send general "hello, team"
quillwire dm send carlos "ping"
quillwire users online

quillwire agent providers            # which LLM providers are configured
quillwire agent chat                 # full TUI: type a task or /chats / /skills / /memory / /keys
quillwire agent run "summarise the last 20 messages in #ops"
quillwire agent listen --channel ops # one-channel listener

Run as a service

The agent can run as a long-lived OS service so it keeps listening to QuillWire DMs, Telegram messages, and incoming webhooks even when no terminal is open.

quillwire agent service install --token <your-token>
quillwire agent service status
quillwire agent service restart
quillwire agent service uninstall

| OS | Mechanism | Auto-restart on crash | Survives logout | | --- | --- | --- | --- | | macOS | launchd user agent (KeepAlive=true) | ✅ | ✅ | | Linux | systemd --user unit + loginctl enable-linger | ✅ (Restart=on-failure) | ✅ when linger succeeds | | Windows | Task Scheduler /SC ONLOGON task | ⚠️ no — pair with NSSM if needed | runs at logon |

install writes the token + server URL to ~/.quillwire.env (chmod 0600) so the service can authenticate without inheriting any shell environment. Logs land in ~/.quillwire/agent-service.log (and .error.log).

Skills & ClawHub

The agent loads skills from ~/.quillwire/skills. Install via ClawHub:

npm i -g clawhub
clawhub search image
quillwire agent skills install image-generation

You can also drive search and install from the QuillWire dashboard's Skills tab — it round-trips through your live agent, so you don't need a terminal open.

Help

quillwire --help                     # full command list
quillwire <command> --help           # per-command details

For the long-form reference, see docs/CLI_Reference.md in the monorepo (regenerate with npm run cli:docs).

Reporting issues

GitHub Issues.