Repository navigation
coding.sh 0.1.0
First public release, pre-1.0. Install with curl -fsSL https://coding.sh/install | sh. It installs the release tarball attached below and runs coding.sh init. The npm package comes with a later release.
Added
- Vercel AI Gateway. Sessions routed through the gateway are tagged
gateway:vercel.coding.sh gateway status|enrichadds billed cost, serving provider, client session join and the resolvedvmc/model per call. The receiver maps gateway trace drains and AI SDKgatewayspans.compare --gatewayand thegatewaygrader provider run arms across models with one key. - Install.
curl -fsSL https://coding.sh/install | shchecks for Node 22.15+, installs the latest release with npm, runscoding.sh init(one plan, one Y/n) and opens the viewer. After that,coding.shwith no command opens the viewer; on first run it sets up capture. - MCP server.
coding.sh mcplets agents query captured sessions, failures, latency, usage, subagents and experiments over stdio.coding.sh initregisters it with Claude Code, Codex, Cursor, OpenCode and Gemini CLI (--no-mcpto skip).coding.sh uninstallrestores each config file byte-for-byte if nothing else edited it since. - Update alerts. Commands print one dim line when a newer release is out. The check runs in the background at most once a day;
coding.sh updateinstalls the release. Off in CI and withNO_UPDATE_NOTIFIER=1,CODING_SH_NO_UPDATE_CHECK=1or[update] check = false. - No ingest step. Read commands, the viewer and the MCP server ingest new hook events first, and the hook starts a background ingest (lock-guarded) when a session ends.
- Capture. Hook-based capture for coding agents: prompts, tool calls, file changes, turns and errors, written to a local spool and ingested into sessions. Secrets are redacted before anything is stored.
- Capture.
coding.sh run -- <cmd>wraps any agent and takes shadow-git snapshots of the working tree before and after, without writing to your repository. - Adapters. claude-code, codex, opencode, cursor, gemini-cli, antigravity, copilot-cli, amp, pi, droid, goose, t3code, aider, and the generic wrapper. Each one has fixture tests and an
ingest --backfillpath where the agent keeps history. Claude Code, Codex and Antigravity are verified on real sessions; the rest are fixture-tested so far. - T3 Code. The t3code adapter imports T3 Code threads from its local store. Codex and Claude Code sessions that T3 runs become one t3code session, with the underlying agent in
provider, instead of being counted twice.coding.sh usage --by agent-modelcompares tokens per turn and cache-read share across harnesses. - Subagents. Subagent starts and ends are captured and linked to their child sessions.
- OTLP receiver.
coding.sh collectoraccepts OTLP/HTTP traces and logs (protobuf or JSON) on 127.0.0.1:4318. It understands OTel GenAI semconv, OpenInference, the Vercel AI SDK and Claude Code / Codex / Gemini CLI log events. - Latency. Every model call becomes an
llm.callevent with model, token usage, duration and time to first token. - Storage. A single SQLite index (node:sqlite, no native deps) plus a content-addressed, zstd-compressed blob store. OTLP and HTTP sinks are metadata-only by default.
- Viewer.
coding.sh uiserves a local viewer: sessions, search, a timeline of turns, tools and subagents, and outcome labels. - Evals. Repo-replay eval tasks that start from the snapshot taken before the agent ran.
eval validatechecks the verifier: a do-nothing attempt fails, the reference fix passes k of k, near-misses fail, and nothing leaks. - Evals. Datasets with deterministic graders, command graders and LLM judges. Judges are calibrated against human labels with Cohen's kappa on a held-out split; uncalibrated judges are flagged in every report.
- Experiments. Run two arms on the same cases and compare them with a paired bootstrap CI of the difference and an exact McNemar test on flipped cases. Harness compare adds per-arm Wilson intervals and the first step where traces diverge.
- Tool evals. Evals for CLI and MCP tool surfaces: description size, schema checks, and per-task tool-call metrics against a sandbox.
- Integrations. eve: span enrichment, a read-only importer for eve's local traces, and an experiment task that drives a local eve agent.
- CLI.
init,doctor,status,ingest,run,collector,uninstall,sessions,show,search,usage,ui,mcp,eval,dataset,exp,judge,toolevals,workflows,harness,compare,gateway,gc,config,update,version, with--jsonoutput. - Docs. README with a quickstart, the agent matrix, OTLP setup, storage, privacy and uninstall; CONTRIBUTING, SECURITY and a release checklist (docs/RELEASE.md).