Skip to content
This repository was archived by the owner on May 1, 2026. It is now read-only.

eddowding/orion_cos

Repository files navigation

Orion

An AI Chief of Staff for Claude Code.

Orion turns Claude Code into a structured life and work operating system. It's a vault of skills, agents, and workflows that give Claude persistent memory, daily routines, and the ability to manage your projects, email, calendar, and tasks autonomously.

This is not a framework. It's a working system — a forkable starter kit you adapt to your life.

What You Get

  • Daily briefings that scan your tasks, email, and calendar
  • Project management with structured frontmatter and mission files
  • 24 slash commands for common workflows (triage, email, meetings, reviews)
  • 5 specialized agents for parallel work (research, outreach, architecture, strategy)
  • Session memory that persists across conversations
  • Autonomous execution on tasks you delegate

Philosophy

Ruthlessly archive what isn't going anywhere. Ruthlessly drive forward what matters.

  • Everything is a Project until archived
  • Max 5 focus items — prioritize brutally
  • The Daily Briefing is the single source of truth
  • Only surface decisions that need human judgment
  • Draft ready-to-send outputs, not research summaries
  • Listen before acting — discuss strategy before executing

Directory Structure

Orion/
├── Cockpit/                 # Daily operations hub (start here)
│   ├── Daily-Briefing.md    # Today's focus (30-sec scan)
│   ├── This-Week.md         # Sprint view
│   ├── Pending-Decisions.md # Needs your brain
│   ├── Context.md           # High-level snapshot
│   └── Rules.md             # Your operating principles
│
├── Projects/                # All active work
│   └── _template/           # Copy this for new projects
│       ├── README.md         # Status, goals, links
│       └── Agent/
│           └── Mission.md   # Working task list
│
├── Operations/Claude/       # The engine
│   ├── skills/              # Slash commands (organized by category)
│   ├── agents/              # Specialized AI personas
│   ├── rules/               # Behavioral guidelines
│   └── setup/               # Bootstrap scripts
│
├── Journal/                 # Reflections & work log
│   ├── personal/            # Daily personal entries
│   └── work/                # Work journal & weekly recaps
│
├── Knowledge/               # Reference material
├── Inbox/                   # Zero-friction capture zone
├── Personal/                # Life stuff
└── Archive/                 # Dormant projects

Quick Start

1. Fork and clone

git clone https://github.com/{YOUR_USERNAME}/Orion.git ~/Orion

2. Personalize

Edit CLAUDE.md and replace the {PLACEHOLDERS}:

  • {YOUR_NAME} — your name
  • {YOUR_EMAIL} — your primary email
  • {YOUR_LOCATION} — city/region
  • {YOUR_TIMEZONE} — IANA timezone (e.g., Europe/London)

3. Run setup

cd ~/Orion/Operations/Claude/setup
./setup-machine.sh ~/Orion

This creates symlinks, generates ~/.claude/settings.json, and wires everything up. It's idempotent — safe to re-run.

4. Set up MCP (optional but recommended)

Orion is powered by MCP (Model Context Protocol) integrations. We use super-mcp to manage multiple MCP servers from a single config.

See Operations/Claude/setup/MCP-GUIDE.md for full setup instructions.

Recommended integrations:

  • Email — Gmail MCP or similar
  • Tasks — TickTick, Todoist, or Linear MCP
  • Calendar — Google Calendar MCP
  • Search — Exa or web search MCP

5. Start using it

cd ~/Orion
claude

Then try:

  • /briefing — get your daily update
  • /triage — prioritize your week
  • /consult <topic> — brainstorm with an expert

Included Skills

Category Skills Purpose
Operations briefing, triage, hygiene, slipping, review, recap, advance, hustle, project-setup, email, inbox-file, extract-entities, wrap Daily routines, project management, email processing
Thinking consult, devils-advocate, thinking-techniques Brainstorming, stress-testing, problem-solving
Meetings meeting-prep, meeting-follow-up Before/after meeting workflows
Personal journal, children Daily reflection, family logging
Documentation write-planning-doc, write-skill Planning docs, new skill creation
Research web-researcher Multi-query web research
System list-extensions Show available commands

Included Agents

Agents are specialized personas launched via the Task tool for parallel work:

Agent Purpose
architect System design, MVP architecture, simplification
pm Project management, team coordination
outreach Cold emails, pitches, partnership messages
gtm-strategist Go-to-market, positioning, channel strategy
market-researcher Targets, contacts, competitors, market data

Add your own agents for your domain — dev, design, legal, whatever you need. See Customization below.

The Plate System

Every active project gets structured frontmatter:

---
priority: this-month    # this-month | next-month | later
goal: "Ship MVP by March"
next-step: "Build landing page"
next-step-owner: odin   # odin = AI can do it autonomously
last-advanced: 2026-03-01
---

Projects with priority: this-month get an Agent/Mission.md — the working task list with goals, priority stack, blockers, and session notes.

The /review skill loops through all active plates weekly. /advance deep-dives into a single project.

Memory System

Orion uses a tiered memory system:

Scope Location What Goes Here
Global behavior ~/.claude/CLAUDE.md Cross-project rules, tool preferences
Vault-wide Cockpit/claude-memory/MEMORY.md Cross-cutting context (auto-loaded)
Per-project Projects/{name}/README.md Project status, goals, contacts
Per-repo technical Per-repo MEMORY.md API gotchas, env patterns

The /wrap skill routes new learnings to the correct tier at session end.

Adding Your Own Skills

# 1. Create the skill file
mkdir -p Operations/Claude/skills/mycategory/myskill
# Write your SKILL.md (use /write-skill for proper format)

# 2. Symlink it for Claude Code discovery
cd Operations/Claude/commands
ln -s ../skills/mycategory/myskill/SKILL.md myskill.md

Skills use [BRACKET] sections and support tool declarations. See /write-skill for the format.

Customization

Add tech stack rules: Create files in Operations/Claude/rules/ for your stack (e.g., python.md, rust.md). They're auto-loaded based on file patterns.

Add agents: Create .md files in Operations/Claude/agents/ with persona descriptions. Claude uses them via the Task tool.

Add MCP integrations: Edit ~/.super-mcp/config.json to add new MCP servers. See the MCP guide.

Change the persona: Edit the [PERSONA] section in CLAUDE.md. Make it yours.

Keeping It Fresh

If you forked from the upstream Orion repo:

git remote add upstream https://github.com/{UPSTREAM}/Orion.git
git fetch upstream
git merge upstream/main  # resolve conflicts in your personalized files

Credits

Built on Claude Code by Anthropic.

MCP integrations via super-mcp.

Inspired by the AI-first development methodology of Greg Detre.

License

MIT

About

Orion CC Chief of Staff

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages