Skip to content
TakoAPI
Back to skills

cairn-cli

by gregoryehill

Notes & PKM
1.3kDownloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Project management for AI agents using markdown files.

Description

What This Skill Does

Cairn is a CLI tool that creates a shared markdown workspace for humans and AI agents to manage projects and tasks together. It tracks task status through a defined workflow and lets you set per-task autonomy levels to control how much an agent can do independently.

Because all data is plain markdown with YAML frontmatter, any AI that can read files works immediately without custom integrations or API connections.

When to Use It

  • Reviewing which tasks an AI agent has in progress before a work session
  • Creating a project charter so an agent has full context before starting work
  • Checking your own assigned tasks across multiple active projects
  • Marking a task blocked with a reason so the agent knows not to proceed
  • Setting agent autonomy to 'draft' so you approve work before it ships

Example Workflow

INPUT

User asks: Start a new project to redesign the docs site and create a first task for the agent

AGENT
  1. 1

    Runs cairn create project "Docs Redesign" --description "Redesign docs site" --objective "Improve clarity and navigation"

  2. 2

    Runs cairn create task "Audit current docs" --project docs-redesign --description "Review all existing pages" --objective "List gaps and outdated content"

  3. 3

    Sets autonomy level to draft so agent completes work but user approves before shipping

  4. 4

    Runs cairn start audit-current-docs to move task to in_progress

  5. 5

    Runs cairn status to confirm workspace reflects the new project and active task

OUTPUT

Project charter and task files created under ~/cairn/projects/docs-redesign/, task status set to in_progress

Installation

clawhub install gregoryehill/cairn-cli

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links