Beppo is an open-source desktop workspace for delegating general tasks to AI agents. It started as a fork of T3 Code, but the product direction is now closer to Claude Cowork: describe an outcome, give the agent the right project folder and context, monitor progress, and come back to a finished deliverable.
Beppo is not primarily a coding GUI. Coding agents and developer tooling may remain under the hood while the fork is early, but the user-facing product should move toward knowledge-work task delegation:
- Organize, rename, summarize, and process local files.
- Prepare documents, reports, spreadsheets, briefs, and other reviewable outputs.
- Synthesize research across files, links, and conversation context.
- Run long-running task sessions with visible progress and human steering.
- Keep consequential actions reviewable and permissioned instead of surprising the user.
Do not add speculative Cowork-style features just because they sound nice. Build the general task workspace from the capabilities that actually exist, then expand deliberately.
This repository is a very early WIP. The inherited architecture still includes Codex, Claude Code, OpenCode, Git, terminal, and source-control concepts from T3 Code. Treat those as implementation substrate unless a task explicitly asks to remove or replace them. New product copy, docs, and UI should call the product Beppo and frame sessions as general work tasks, not coding-agent threads.
Beppo currently depends on locally authenticated agent providers inherited from T3 Code. Install and authenticate at least one provider before use:
- Codex: install Codex CLI and run
codex login - Claude: install Claude Code and run
claude auth login - OpenCode: install OpenCode and run
opencode auth login
npx t3Before local development, prepare the environment and install dependencies:
# Optional: only needed if you use mise for dev tool management.
mise install
bun install .We are not accepting external contributions yet.
Before making changes, read AGENTS.md. It defines the current project contract, validation gates, package roles, and the Beppo product direction.
Observability guide: docs/observability.md