Skip to content
core-agent
core-agent

core-agent

A reusable Go-based agent built on the Google Agent Development Kit. Embed it in your binary, pick the providers and tools you need, ship.
Run the CLIEmbed the libraryGitHub

Two ways to use it

Section titled “Two ways to use it”
Run the CLIDrive an agent from your terminal — Bubble Tea TUI, slash commands, or headless one-shot with -p.
Embed the libraryAdd core-agent to your Go binary. Bring your own UI, tools, providers, and runtime topology.

What you get

Section titled “What you get”
Autonomous runsautonomous.Run loops the model toward a goal with budgets (turns / tokens / cost / wallclock). autonomous.Resume picks up after a crash.
Durable sessions + audit logeventlog.Open returns a SQLite/Postgres/MySQL-backed session.Service plus a Stream with Since(seq) replay and Watch(seq) live tail.
In-process subagentsagent.WithSubagents registers each as a callable tool. Subagent events stream into the parent's audit log under a branch-scoped path.
Remote TUI + multi-session daemoncore-agent-tui attaches to any daemon over HTTP + SSE. One daemon serves many concurrent sessions with per-caller ACLs.

Why core-agent

Section titled “Why core-agent”

core-agent is an opinionated substrate on top of Google’s Agent Development Kit. It wraps ADK with the parts that aren’t about model intelligence but about being a real piece of software: a permission system humans trust, multiple model backends behind one config, a durable event log that survives crashes and powers replay, skills, MCP server lifecycle, autonomous-run budgets, in-process and remote subagents, context-management mechanisms that keep long sessions alive past the model’s context wall, per-model cost tracking, and a headless CLI that’s useful in five minutes.

Every one of those is something you’d write before shipping. Pulling them in as a library is a one-day exercise; building them yourself is two engineer-months.

→ Full comparison in Why core-agent.

Install

Section titled “Install”
Terminal window
go install github.com/go-steer/core-agent/v2/cmd/core-agent@latest

Or go get github.com/go-steer/core-agent/v2 if you’re embedding.