Feat/agctl phase1 cli

[vinodvx]

Description

Phase-1 agctl CLI: Kong-based commands for running agents from the terminal with layered config.

What changed

• Added chat, run, version, and config path|show|edit subcommands
• Kong CLI in cli/ with shared chat/run flags via embed
• Layered config merge: embedded default.yaml → XDG → --config / AGCTL_CONFIG → AGCTL_* env → flags
• No init — run with defaults + env; config edit seeds from embedded default on first save
• Agent build from config: tools toggles, MCP servers, conversation store, local/temporal runtime
• Renamed env prefix to AGCTL_*; secrets via env (AGCTL_LLM_APIKEY)
• End-user docs: docs/getting-started/cli.mdx; contributor guide: cli/README.md

How validated

• cd cli && go test ./... — config merge, agent build, tools, secrets, CLI parsing
• task examples:all — 32/32 local examples pass
• Manual smoke: agctl version, agctl config show, agctl run --prompt, agctl chat

Type of change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)
• Documentation update
• Refactor / chore

Related issues

Closes #49

Checklist

• I have run task check
• I have run task examples:all
• I have run task tidy if I added or removed dependencies
• Commit messages follow conventional commits (e.g. feat:, fix:, docs:)
• I have added/updated tests for my changes
• Documentation is updated if needed

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
agent-sdk-go	🟢 Ready	View Preview	Jul 20, 2026, 9:43 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[codecov]

Codecov Report

❌ Patch coverage is 11.39241% with 70 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
eval-harness/runner/setup/config.go	10.52%	53 Missing and 15 partials ⚠️
benchmarks/setup/config.go	33.33%	0 Missing and 2 partials ⚠️

📢 Thoughts on this report? Let us know!