🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί letcairn.work
πŸ¦€ ClawHub

letcairn.work

by @gregoryehill

Project management for AI agents using markdown files. Install and use the cairn CLI to create projects, manage tasks, track status, and coordinate human-AI collaboration through a shared workspace of markdown files.

Versionv1.0.2
Downloads2,069
Installs1
#legal#productivity
TERMINAL
clawhub install cairn-cli

πŸ“– About This Skill

name: cairn description: Project management for AI agents using markdown files. Install and use the cairn CLI to create projects, manage tasks, track status, and coordinate human-AI collaboration through a shared workspace of markdown files.

Cairn β€” AI-Native Project Management

Cairn gives you and your AI agent a shared workspace of markdown files for managing projects and tasks. Statuses are the shared language. Any AI that can read files is ready to go.

Installation

npm install -g cairn-work
cairn onboard

cairn onboard creates ~/cairn/ with auto-generated context files (AGENTS.md and .cairn/planning.md) that agents read automatically.

Community

  • Follow @letcairnwork on X
  • Visit letcairn.work
  • Submit issues
  • Join the discussion

    • Core Commands

    Workspace

  • cairn status β€” Overview with task counts
  • cairn my β€” Your assigned tasks
  • cairn active β€” All in-progress tasks
  • cairn doctor β€” Diagnose workspace health

    • Projects & Tasks

  • cairn create project "Name" --description "..." --objective "..." β€” Create a project with charter
  • cairn create task "Name" --project --description "..." --objective "..." β€” Create a task
  • cairn list tasks [--status pending,in_progress] [--project slug] β€” List tasks with filters
  • cairn search "keyword" β€” Find tasks by content

    • Task Workflow

  • cairn start β€” Begin work (sets in_progress)
  • cairn note "Progress update" β€” Add a status note
  • cairn artifact "Artifact Name" β€” Create a linked deliverable
  • cairn done β€” Finish work (moves to review or completed)
  • cairn block "Reason" β€” Mark as blocked

    • Maintenance

  • cairn update-skill β€” Refresh context files after CLI updates
  • cairn upgrade β€” Update CLI to latest version

    • Workspace Structure

    ~/cairn/
  AGENTS.md                  # Agent context (auto-generated)
  .cairn/planning.md         # Planning guide (auto-generated)
  projects/
    project-slug/
      charter.md             # Why, success criteria, context
      artifacts/             # Deliverables (design docs, proposals, etc.)
      tasks/                 # Individual task markdown files
  inbox/                     # Ideas to triage
  memory/                    # Workspace memory

    Statuses

    pending β†’ next_up β†’ in_progress β†’ review β†’ completed (or blocked at any point)

    Autonomy Levels

    Set per-task to control how much the agent can do:

  • propose β€” Agent plans only, finishes in review
  • draft β€” Agent does work, you approve before shipping
  • execute β€” Full autonomy, finishes as completed

    • Tips

  • Run cairn onboard first β€” it sets up everything the agent needs.
  • Use cairn my to see your current workload at a glance.
  • Artifacts (cairn artifact) create linked deliverables stored with the project.
  • All data is plain markdown with YAML frontmatter β€” version control friendly.

    • πŸ“‹ Tips & Best Practices

  • Run cairn onboard first β€” it sets up everything the agent needs.
  • Use cairn my to see your current workload at a glance.
  • Artifacts (cairn artifact) create linked deliverables stored with the project.
  • All data is plain markdown with YAML frontmatter β€” version control friendly.