# Until v1.0 install the latest pre‑release tag
npm install -g @astrotask/cli@next      # or: pnpm / yarn

npm update -g @astrotask/cli

# 1. Create a workspace
mkdir my-project && cd $_

# 2. Initialise Astrotask (creates ./data/astrotask.db and starter rules)
astro init

# 3. Add tasks and view them
❯ astro task add "Create README"
❯ astro task generate --file docs/task-generation-implementation.md
❯ astro task tree
🌳 Task Tree (All Tasks) (pending and in-progress only)
💡 Use --show-all to include completed and archived tasks
├── ⏳ Create README (AFDR) [pending]
├── ⏳ Task ID System and TaskTree Architecture (BXCQ) [pending]
│   ├── ⏳ Create task creation logic (BXCQ-RKGO) [pending]
│   ├── ⏳ Implement task tree structure (BXCQ-BTTS) [pending]
│   ├── ⏳ Implement task ID validation functions (BXCQ-PDPT) [pending]
│   ├── ⏳ Implement subtask ID generation function (BXCQ-ZGWZ) [pending]
│   ├── ⏳ Implement task ID generation function (BXCQ-QDPA) [pending]
│   └── ⏳ Design database schema for tasks (BXCQ-FUZS) [pending]

# 4. Open the live dashboard (press <c> to toggle completed tasks)
astro dashboard

import { createAstrotask } from "@astrotask/core";

const astrotask = await createAstrotask({
  databaseUrl: "./data/astrotask.db",
});

await astrotask.tasks.addTask({
  title: "Implement OAuth",
  description: "Add Google login",
});

{
  "mcpServers": {
    "astrotask-task": {
      "command": "npx",
      "args": ["@astrotask/mcp"],
      "env": {
        "DATABASE_URI": "/home/toda/dev/astrotask/data/astrotask.db"
      }
    }
  }
}

astro init

$ Start working on the next task and track your progress in astrotask

{
  "name": "getNextTask",
  "arguments": { "priority": "high" }
}

# Simple capture
astro task add "Write onboarding docs"

# Add under a parent and set priority
astro task add "Design hero section" --parent <parentId> --priority high

astro task generate --file ./specs/authentication.prd.md
# Use --dry to preview without touching your DB

{
  "name": "addTasks",
  "arguments": {
    "tasks": [
      {
        "title": "Refactor caching layer",
        "description": "Move from LRU to ARC",
        "priority": "medium"
      }
    ]
  }
}