Run your work like an AI agency, from a single Notion board. Agents discuss, plan, and execute tasks in parallel with dependency ordering and model routing.

MIT License

Free Pricing

Installation

Open Claude Code and run this command:

/plugin install agency-os@claude-code-plugins-plus

Use --global to install for all projects, or --project for current project only.

What It Does

> Run your work like an AI agency, from a single Notion board.

Turn Notion into the dashboard of your own AI agency. You discuss ideas with the agent, it clarifies scope and writes the plan into Notion, you approve, and agents ship the work in parallel - with result links back on the row.

Skills (1)

agency-os SKILL.md View full skill →

Notion-as-source-of-truth dispatch board for running your work like an AI agency.

ReadWriteEditBash(python3:*)Bash(npx:*)GlobGrep

agency-os

Notion-as-source-of-truth dispatch board. One Tasks database, one Hub page, one

page per Corpus, one page each for General Guidance and Resources. The skill

mutates Notion via the Notion MCP (mcpnotion- tools); only

references/notion-pointers.json is committed to git.

Skill name decision: the skill is named agency-os (matching the repo). All

commands are /agency-os . This is the single plugin entry point; there

is no agency-os/notion sub-namespace. If you embed this plugin alongside

others, prefix commands with agency-os to avoid collisions.

Overview

agency-os turns a single Notion database into a multi-status dispatch board for

AI work. The model is intentionally narrow:

One Tasks database is the source of truth for status, priority, model

selection, and ownership. No parallel kanban tools.

One Hub page holds the General Guidance, Resources, and Corpus pointers

that every task consults.

Tasks flow through five statuses: Suggestion → Discussion → To-Do →

In Progress → Done. The dedup gate at each transition prevents accidental

re-execution.

run fans approved To-Do rows out to parallel agents. Each task carries

its own model selection (Haiku for cheap fan-out, Sonnet for default,

Opus for hard reasoning) and respects declared dependencies.

The skill is stateless on disk — the only committed artifact is

references/notion-pointers.json (database/page IDs). All runtime state lives

in Notion.

For the full architecture (status flow, sync protocol, workspace structure,

pointer/cache format), see references/architecture.md.

Prerequisites

Notion MCP server installed:

npx -y @notionhq/notion-mcp-server (declare in .mcp.json)

Notion integration token (NOTION_TOKEN) with read+write access to your

workspace. Add .env to .gitignore — never commit the token.

A Notion Tasks database with the columns the skill expects (see

references/architecture.md § "Workspace structure" for the schema). The

/agency-os init command can scaffold this for you.

Python 3 for the optional scripts/query-tasks.py helper.

First-time setup:


ccpi install agency-os
# then in Claude Code:
/agency-os init --harness=basic --haiku=cost-ti



      
      
          How It Works
          
Install the plugin from your terminal: ccpi install agency-os
Duplicate the public Notion template into your workspace.
Create a Notion integration at https://www.notion.so/my-integrations and share it with the duplicated page.
Add NOTIONKEY=secret... to your .env (and ensure .env is in your .gitignore).
Restart your claude session and run /agency-os scaffold in the chat to wire the board.

Full setup guide: https://github.com/ratamaha-git/agency-os/blob/main/docs/harnesses/claude-code.md
        

      
      

      
      

      
      
  Ready to use agency-os?
  
    
    
  




      
      
          Related Plugins
          
            
  discovery-questionnaire
  Generate custom discovery questionnaires for AI agency prospects
  /plugin install discovery-questionnaire@claude-code-plugins-plus
  

  make-scenario-builder
  Create Make.com (Integromat) scenarios with AI assistance
  /plugin install make-scenario-builder@claude-code-plugins-plus
  

  n8n-workflow-designer
  Design complex n8n workflows with AI assistance - loops, branching, error handling
  /plugin install n8n-workflow-designer@claude-code-plugins-plus
  

  roi-calculator
  Calculate and present ROI for AI automation projects
  /plugin install roi-calculator@claude-code-plugins-plus
  

  sow-generator
  Generate professional Statements of Work for AI projects
  /plugin install sow-generator@claude-code-plugins-plus
  

  zapier-zap-builder
  Create multi-step Zapier Zaps with filters, paths, and formatters
  /plugin install zapier-zap-builder@claude-code-plugins-plus
  

          
        

      
      
          Tags
          
            notiontask-managementai-agencyautonomous-agentworkflowproject-managementclaude-code