agentic/residual-agent
Watch
5
0
Fork
You've already forked residual-agent
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Autonomous agentic harness for residual (24/7 daemon, ACP interface). Working repo; destined for git.merith.xyz/residual/agent.
23 commits 1 branch 0 tags 78 KiB
  • Go 100%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
muse-lantern 577ca0f9dc llm providers, sqlite memory, built-in MCP server, agent mcp command
2026-10-08 19:22:38 +00:00
cmd/agent llm providers, sqlite memory, built-in MCP server, agent mcp command 2026-10-08 19:22:26 +00:00
internal llm providers, sqlite memory, built-in MCP server, agent mcp command 2026-10-08 19:22:38 +00:00
testdata acp: agent-side server + opencode-acp provider design 2026-10-07 17:38:40 -07:00
.gitignore scaffold: add .gitignore 2026-10-08 00:24:54 +00:00
DESIGN.md pivot: ACP client, workspaces/identities, mcp-sync (opencode) 2026-10-07 18:04:09 -07:00
go.mod llm providers, sqlite memory, built-in MCP server, agent mcp command 2026-10-08 19:22:19 +00:00
go.sum llm providers, sqlite memory, built-in MCP server, agent mcp command 2026-10-08 19:22:23 +00:00
README.md pivot: ACP client, workspaces/identities, mcp-sync (opencode) 2026-10-07 18:04:09 -07:00

README.md

agent

Autonomous agentic harness for residual — a 24/7 daemon that does work on its own, built to residual's design constraints.

  • Runs on device (e.g. Raspberry Pi with a screen); supervised by res-init with respawn for uninterrupted operation.
  • Pluggable LLM backends: a direct API (OpenAI-compatible or Anthropic) or an external ACP harness it drives as a client (opencode acp, claude-code-acp, …). It does not serve ACP itself.
  • Workspaces & identities: each agent gets AGENT_DATA/workspace/<name> as its home; persona and config live in AGENT_DATA/identities/ (agents/ and subagents/, md+yml pairs).
  • mcp-sync: MCP servers declared once in agent config are translated into harness-native workspace configs (opencode officially supported).
  • Long-term memory in sqlite, exposed through built-in MCP tooling so agents persist efficiently.
  • The only external dependency is an LLM provider.

See DESIGN.md for the architecture.

Layout

cmd/agent/            entrypoint
internal/
  acp/                DEAD CODE (intentional): ACP agent-side, kept for reference
  acpclient/          ACP client: spawn + drive external harnesses
  workspace/          AGENT_DATA layout, identity (md+yml) loading
  mcpsync/            canonical config → harness workspace configs
  memory/             (next) sqlite long-term memory

Status

See DESIGN.md § "Milestones".