cs-agent

# CS Agent CS Agent is a standalone MCP runtime that launches and observes read-only reviewer agents with a unified lifecycle interface. It currently uses Paseo as a runtime adapter while keeping the caller decoupled from the specific agent backend. > Current status: pre-release. Source and tests are available, but a stable platform package has not been released; do not consider `main` as a stable release. ## Relationship with CodeStable Skills CS Agent is an optional capability, not a runtime dependency of CodeStable skills. CodeStable skills should perform independent reviews through multiple agent capabilities available to the host; the host can provide native Agents, Paseo, CS Agent, or other equivalent implementations. This repository does not contain or bundle CodeStable skills. ## Current Capabilities - MCP tools: capabilities, create, list, status, messages, send, permission response, result, close. - reviewer-only, asynchronous lifecycle, and structured errors. - Prefer reuse of compatible external Paseo; platform packages may use isolated private Paseo runtime. - Routes only save backend references required for recovery, not transcripts or credentials. - External runtime is managed by the user; CS Agent does not stop, upgrade, or take over it. ## Local Build Requires Go 1.22 or later: ```bash go build -o ./bin/cs-agent . go test ./... go vet ./... ``` Source builds do not include a private Paseo closure by default. If you have the `paseo` CLI available on your machine, you can configure the MCP server to let CS Agent discover and reuse it: ```json { "mcpServers": { "cs-agent": { "command": "/absolute/path/to/cs-agent", "args": [], "env": { "CS_AGENT_EXTERNAL_DISCOVERY": "path", "CS_AGENT_DISABLE_PRIVATE": "1" } } } } ``` When no runtime is available, `cs_agent_capabilities` will explicitly return `runtime_unavailable` and not advertise a pseudo-success capability without a provider. Callers should continue to try the host's native Agent or other reviewer capabilities. ## Release Package Check The release builder generates `cs-agent` for the target platform, a fixed Paseo production closure, host manifest, and licensing records: ```bash python3 tools/build-agent-runtime.py --check --target darwin-arm64 --json ``` Supports `darwin-arm64`, `darwin-amd64`, `linux-amd64`, `linux-arm64`, and `windows-amd64`. Real Codex/Claude E2E testing is still required on the target host before release. Architecture and ownership information can be found in [docs/architecture.md](docs/architecture.md). ## License AGPL-3.0-or-later. Node.js, Paseo, and other third-party dependencies in the release package retain their respective upstream licenses.