Free · MIT licensed

agency-os

Turns a Notion board into the dashboard of a small AI agency. Drop in an idea - the agent plans it into sequenced subtasks, you approve, it ships. Results land back in Notion. You stay in the deciding seat.

How it works

One board, one loop. Everything else is the agent's job.

Step 1

Suggest

Drop an idea into the inbox. One line is enough. The agent handles the rest.

Step 2

Plan

The agent breaks the idea into subtasks, sequences them by dependency, picks the right model for each, and hands you back a plan.

Step 3

Approve

You're the gate. Nothing runs without your nod. Push back on the plan if it's wrong, or flip the switch.

Step 4

Ship

Approved tasks run in parallel where possible, in order where they depend on each other. Results land back on each row in Notion with a link.

What makes it different

Agent is the planner, not just the doer

You don't fill in subtasks. The agent decomposes the idea, builds the dependency graph, and presents a plan. You judge it - fast.

Dependencies actually work

If task B depends on task A, task B doesn't fire until A finishes. No half-shipped workflows, no announcement before the assets are ready.

Operator gating is non-negotiable

Nothing dispatches without your approval. Every queued task is visible on the board. No surprise autonomous action at 3am.

Right model for each subtask

Mechanical form fills go to fast cheap models. Nuanced drafts go to stronger ones. The plan picks the model - you can override, but usually don't need to.

Everything in Notion

No new dashboard. No new login. The result link is on the task row. If you can use Notion, you can use this.

Portable by design

Ships as a Claude Code plugin over MCP. Runs in Cursor, Cline, or any MCP-capable harness. Your board and commands travel with you.

Install in 5 steps

  1. Install the plugin in Claude Code /plugin install https://github.com/ratamaha-git/agency-os
  2. Duplicate the public Notion template into your workspace
  3. Create a Notion integration at notion.so/my-integrations and share it with the duplicated page
  4. Add your token to .env NOTION_KEY=secret_...
  5. Wire up the board /agency-os scaffold

Works with Claude Code, Cursor, Cline, and any MCP-compatible agent harness.

FAQ

What does it cost?
The plugin is MIT-licensed and free. You pay for model usage (Claude API) and Notion. Per-task model dispatch typically cuts model spend by an order of magnitude versus running everything on a flagship model.
Who is it for?
Founders tired of being the bottleneck. Solo operators who want a junior teammate. Small teams that live in Notion and want deliverables, not just drafts. Makers with a pipeline of content, submissions, and outreach that needs to go out.
What does it not do?
No autonomous dispatch - if you didn't approve it, it doesn't run. No black-box agent runs - every step is on the board. No "swarm" theater. No lock-in - the skill spec is portable across harnesses.
What's on the roadmap?
Richer planning hints (agent learns from your past approvals), more integrations (Ghost, Beehiiv, Linear, Slack), team mode with role-based gates, and self-pacing loops for recurring tasks.

Want help wiring it into your workflow?

We use agency-os internally to run content, outreach, and ops. If you want it set up and tuned for your specific pipeline, we can do that.

Get in touch