vers-agent Skill | Agent Skills

vers-agent

ACP (Agent Client Protocol) harness for AI coding agents with session persistence and streaming.

Quick Start

bun install && bun run build
export ANTHROPIC_API_KEY=sk-ant-...
./vers-agent

Essential Commands (justfile)

| Action | Command | |--------|---------| | Start everything | just up | | Server only | just server | | CLI only | just cli | | Status dashboard | just status | | Pre-commit check | just check | | Nuclear reset | just nuke | | One-shot prompt | just ask "your prompt" |

Modes

| Flag | Description | |------|-------------| | ./vers-agent | Server + CLI (default) | | --server | HTTP server only (:9999) | | --cli | CLI connecting to localhost | | --url <host> | CLI connecting to remote | | --local | Local mode with debug logging |

CLI Keybindings

Enter - Submit | Shift+Enter - Newline
Tab - Autocomplete | Ctrl+C - Cancel/Exit
@path - File completion | /cmd - Commands

Session Commands

/new - New session | /continue - Resume last
/sessions - List all | /model - Change model
/agent - Switch agent | /plan - Toggle plan mode

Troubleshooting

| Problem | Fix | |---------|-----| | Port in use | just kill-port | | Auth locked | just reset-claim | | Full reset | just nuke | | Complete wipe | just pristine |

API Endpoints

POST /rpc - JSON-RPC handler
GET /events - SSE stream
GET /health - Health check
GET /metrics - Prometheus metrics

Data Location

~/.vers-agent/ contains sessions.db, tokens.json, config.json, and logs.

Agent Skills: vers-agent

Install this agent skill to your local

Skill Files