Goated

goated

Goated is an always-on personal AI assistant, built around Claude Code and Codex. It's minimal, performant, and piggybacks on the best harnesses in the world for long-running sessions.

Written in golang, with cobra + viper + bbolt + tmux + crontab.

**Why Goated vs. OpenClaw?**

Well, besides the fact that many (most?) OpenClaw users are violating Claude Code's TOS by hijacking their Max credentials: Goated is also simply faster, smaller, and _much_ more performant.

This is because most agent frameworks own the context window — they inject bootstrap files, manage session history, and accumulate state in-process until memory explodes. Goated doesn't touch the context window at all. It's a ~20 MB daemon that pastes message envelopes into tmux and lets Claude Code, Codex, or Pi handle its own context compaction, memory, and token budgeting. The result: no token bloat, no session file growth, no multi-GB memory leaks. Just a thin orchestrator that stays out of the way. See [docs/PERFORMANCE.md](docs/PERFORMANCE.md) for the full comparison.

Out of the box, Goated supports:

• Slack and Telegram chat interfaces
• Claude Code and Codex in both headless and TUI modes
• Pi in headless mode
• Long-running daemon operation with watchdog recovery
• Obsessive, automatic Obsidian-style notetaking with the excellent notesmd CLI
• Cron jobs and headless subagents
• File-backed credential management
• Session health checks, restart handling, and queueing
• A seeded private workspace/self repo with bundled note-taking tools and an extensible Cobra-based personal CLI

**For AI agents working on this codebase:** see [CODEBASE.md](CODEBASE.md) for architecture and [AGENTS.md](AGENTS.md) for build/run instructions.

Quickstart

Goated works best on Linux (in a VM, a dedicated box, or a VPS). The maintainer recommends a DigitalOcean droplet or EC2 Instance with 4GB memory. You can run it o