接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
npx -y [email protected]Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
claude mcp add io.github.aabxtract-koda -- npx -y koda-verify@0.3.2在終端機中執行。
{ "mcpServers": { "io.github.aabxtract-koda": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
遠端 URL 還是本機指令？ 兩種安裝方式的差異
來自發布者
Verification and memory for coding-agent workflows. Install once, verify the changes that matter, remember what keeps breaking.
1,000+ downloads on Open VSX — Koda is already watching commits in editors around the world.
Verification and memory layer for coding-agent workflows.
| npm | npm install -g koda-verify (npmjs.com) |
| IDE | Open VSX — works in VS Code, Cursor, Windsurf, VSCodium |
| MCP | Registry |
| Landing | aabxtract.github.io/koda |
Coding agents write features in minutes — but who verifies every commit? Full test suites are too slow to run per commit, so most verification happens late (or never). Koda closes that gap: on every commit it verifies only what changed, in seconds-to-minutes, and remembers what keeps breaking so your agent stops reintroducing old bugs.
Koda never writes code. It orchestrates verification, remembers patterns, and reports — to both the human and the agent.
git commit
│
▼
pre-commit ── secret guard (blocks committed API keys / private keys)
│
▼
post-commit ── koda run (background, never blocks you)
│
▼
1. Read diff ──────────── classify files: api / page / component / lib / config / test
2. Impact analysis ────── agent-supplied (MCP) → Groq fallback → deterministic heuristics
3. Kane browser flows ─── headless, scoped to changed UI only (page/component changes)
4. Endpoint checks ────── GET / HEAD / OPTIONS only; regressions flagged (200 → 500)
5. Integration tests ──── Jest / Vitest / Mocha / node:test, matched to changed files
6. Report ─────────────── JSON (agent-readable) + Markdown (human-readable)
7. Memory ─────────────── recurring patterns, resolution history, time-to-fix
Most commits never launch a browser: API/config/test-only changes verify with endpoints + tests in seconds. Browser flows fire only when UI files change.
npm install -g koda-verify
cd your-project
koda init # creates .koda/, installs git hooks, detects your app's port
koda doctor # verifies: git, config, Kane CLI, target URL, directories
Then just keep committing — verification runs in the background on every commit.
Browser flows are powered by the Kane CLI. The IDE extension onboards it for you: click Enable and Koda offers to install Kane and connect your account. Or do it manually:
npm install -g @testmuai/kane-cli
kane-cli login --oauth # opens your browser — use (or create) YOUR OWN Kane account
Koda ships zero credentials. Every Koda user authenticates their own Kane account:
~/.testmuai/ on your machine — never synced, never proxiedKANE_USERNAME / KODA_ACCESS_KEY-style secretsNo Kane? No problem. Koda runs in degraded mode: endpoint checks, integration tests, memory, and reports all work; browser flows are honestly marked SKIPPED — never faked.
Koda verifies whatever your app points at. The default is auto-detected at koda init (probes common dev ports: 3000, 5173, 8080, 8000, 4200, 5000…). Override it three ways:
koda target https://myapp.vercel.app # permanent — hosted URL, https auto-detected
koda target 192.168.1.5:8080 # LAN IP, http auto-detected
koda run --target https://preview-123.example.com # one-off run
KODA_TARGET=https://staging.example.com # per-session / CI via env
Precedence: --target flag → KODA_TARGET env → .koda/config.json → auto-detected default.
claude mcp add koda -- npx koda-verify mcp
Works with any MCP client: Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Zed. In a development checkout: claude mcp add koda node /absolute/path/to/koda/mcp/server.js.
agent edits code → commits → hook fires koda run → report written
→ agent calls koda_verify (its own flows) / koda_report via MCP
→ reads the verdict → fixes what failed → commits again
→ memory marks the failure RESOLVED (with time-to-fix recorded)
Reports record analysis_source: 'agent' when the agent supplied flows — verifiable proof the loop is agent-driven.
Every run writes a timestamped pair to .koda/reports/:
.koda/reports/2026-08-30T14-35-28-909Z-9416b29.json ← agent-readable
.koda/reports/2026-08-30T14-35-28-909Z-9416b29.md ← human-readable
The JSON includes: commit metadata, analysis_source (agent / llm-fallback / fallback), risk level, per-check results with evidence file paths, memory context (similar failures, patterns, fix confidence), and action_required with priority and suggested focus. Markdown renders PASS / FAIL / SKIPPED distinctly with coverage status.
Raw Kane session events are preserved per-flow under .koda/evidence/.
time_to_fix_msapp/page.js") resolve automatically once a passing test covers those filesallow_mutating_methods: true) plus agent-declared endpointsSKIPPED, never reported as failures; skipped checks never enter memorykoda cicd
Generates .github/workflows/koda.yml from a validated template: Node setup, npm ci, build-if-present, Kane CLI install + auth via GitHub secrets (KANE_USERNAME, KANE_ACCESS_KEY), app start, wait-on target, koda run --commit ${{ github.sha }}. Template-first — no LLM-generated YAML. Refuses to overwrite without --force.
.koda/config.json){
"kane": {
"target": "http://localhost:3000",
"headless": true,
"max_steps": 30,
"timeout_ms": 300000
},
"tests": {
"browser_flows": true,
"endpoint_tests": true,
"integration_tests": true,
"allow_mutating_methods": false,
"expected_statuses": { "GET /api/health": [200] }
},
"notify": { "telegram": false, "discord": false }
}
Optional — Koda works without any of these. Loaded from the project .env, falling back to ~/.koda/.env (configure once, use everywhere):
GROQ_API_KEY= # Groq fallback impact analysis (agent runs skip this entirely)
KODA_TARGET= # override target URL (flag > env > config)
KODA_TEST_TOKEN= # bearer token for authenticated endpoint checks
KODA_PROJECT= # default project path for CLI/MCP
TELEGRAM_BOT_TOKEN= # notifications
TELEGRAM_CHAT_ID=
DISCORD_WEBHOOK_URL=
npm install
npm run check # syntax-check all sources
npm test # node:test suite
npm link # local koda binary for development
See koda-v3-build-guide.md for the full implementation contract.
MIT
{ "mcpServers": { "io.github.aabxtract-koda": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式，而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Koda 透過 stdio 在本機執行。
上次檢查時間：2026-11-09。 Verification and memory layer for coding-agent workflows.