# Draxarp > Manage Draxarp Intelligence — projects, tasks, specs, docs, memories, sprints, knowledge graph, context captures, and task decomposition via orbit CLI - Skill: `jorgemuza/draxarp` (Agent Skill) - Install (CLI): `npx skillmds@latest add jorgemuza/draxarp` - Raw SKILL.md: https://api.skillmd.com/api/skills/jorgemuza/draxarp/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Productivity - Author: jorgemuza (https://skillmd.com/u/jorgemuza) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/jorgemuza/draxarp --- # Draxarp Intelligence — orbit CLI Alias: `dx` The `orbit draxarp` (or `orbit dx`) command manages the Draxarp Development Intelligence module — a second brain for LLM-assisted development. It covers nine resource types: ## Resources | Resource | Alias | Description | |----------|-------|-------------| | `project` | `proj` | Intelligence projects — group tasks, specs, memories, and docs | | `task` | — | Development tasks with status, priority, activity logs, handoffs, focus, and dependencies | | `memory` | `mem` | Persistent knowledge — patterns, bugs, decisions, domain context | | `spec` | — | Specifications with review workflow (draft → review → approved/rejected) | | `doc` | — | Technical documentation with slug-based addressing and wikilink support | | `sprint` | — | Sprint planning with velocity tracking and AI content suggestions | | `capture` | `cap` | Context captures — git commits, PRs, CI events, deployments | | `graph` | `kg` | Knowledge graph — nodes, edges, impact analysis, subgraph, path finding | | `decompose` | — | AI-powered task decomposition from descriptions | ### Tracking (via `orbit tracking`) | Command | Description | |---------|-------------| | `tracking event push` | Push workflow events (skill completions, Jira transitions, agent invocations) | | `tracking tkm push` | Push token usage data from local TKM database | ### Tracking admin & diagnostics (via `orbit dx tracking`, alias `trk`) | Command | Description | |---------|-------------| | `tool-versions` / `tv` | Show/set latest expected tool versions (orbit, claude-code, paybook-workflow) | | `doctor ` | Per-user pipeline diagnosis with verdict and actionable hints | | `pipelines` | Cluster-wide pipeline health + list of "stuck users" | | `tail` | Tail ingest events across both pipelines; supports `--follow` | | `api-logs` | Query the `api_logs` table (when request logging is enabled) | | `hooks` | Inspect local `~/.claude/settings.json` ingest hooks (offline) | | `hooks install` | Idempotently wire a `Stop` hook that runs `tracking tkm push` after every Claude Code response | | `hooks uninstall` | Remove `tracking tkm push` `Stop` hooks while preserving unrelated hooks | ```bash # Diagnose why events stopped flowing for a user orbit dx trk doctor manuel.toala@paybook.me # Cluster health + stuck users orbit dx trk pipelines # Real-time stream for a single user orbit dx trk tail --user manuel.toala@paybook.me --follow # Verify the user's local hooks still reference the ingest endpoints orbit dx trk hooks # First-run setup: wire the token-usage Stop hook (idempotent) orbit dx trk hooks install --bake-profile paybook ``` > Without `hooks install`, token-usage events only flow when a skill that embeds `tracking tkm push` (e.g. `paybook-workflow:commit`, `paybook-workflow:prime`) is explicitly used — producing false `TOKEN_USAGE_BROKEN` verdicts in `doctor`. ## Quick Reference ### Projects ```bash orbit dx proj ls # List projects orbit dx proj view # View project details orbit dx proj create --name "My Project" # Create project orbit dx proj delete # Delete project ``` > **Slugs everywhere:** All `--project` flags and resource IDs accept either UUIDs or slugs. > Use slugs for readability: `--project draxarp-portal` instead of `--project 019cf38c-...` ### Tasks — Core CRUD ```bash orbit dx task ls --project # List tasks for a project orbit dx task ls --status in_progress # Filter by status orbit dx task ls --type epic --project # List only epics orbit dx task ls --parent # List children of an epic orbit dx task view # View task details + last 5 activity logs orbit dx task create --title "Fix bug" --project --priority high orbit dx task create --title "Wire frontend" --project --depends-on orbit dx task create --title "Auth" --project --type epic # Create an epic orbit dx task create --title "JWT" --project --type story --parent # Story under epic orbit dx task update --status testing --activity "Running PHPUnit" orbit dx task assign --assignee claude # Assign task orbit dx task start # Set status to in_progress orbit dx task complete # Mark completed (with guard checks) orbit dx task delete # Delete task orbit dx task epic # Show epic progress (% complete, children) ``` Task types: `task` (default), `epic`, `story` ### Tasks — Focus & Next (session management) ```bash orbit dx task focus # One command: assign + start + set focus orbit dx task focus --agent claude # Specify agent (default: claude) orbit dx task current # Show currently focused task orbit dx task current --agent claude # For a specific agent orbit dx task next --project # Next available task by priority (skips epics & blocked) ``` ### Tasks — Activity Logs ```bash orbit dx task log "Implemented API endpoints" --tag progress orbit dx task log "Blocked on DB schema" --tag blocker --agent claude orbit dx task log "Chose approach A over B" --tag decision orbit dx task logs # List all logs (newest first) orbit dx task logs --tag blocker # Filter by tag orbit dx task logs --limit 10 # Limit results orbit dx task logs -o json # JSON output ``` Activity log tags: `progress`, `blocker`, `decision`, `hypothesis`, `tried`, `result`, `handoff`, `note` ### Tasks — Structured Handoffs & Context ```bash # Record a handoff (session continuity) orbit dx task handoff \ --done "Implemented X" --done "Added tests for Y" \ --remaining "Wire up frontend" --remaining "Add error handling" \ --decision "Used approach A because of constraint B" \ --uncertain "Not sure if Z is the right abstraction" \ --files "backend/Services/Foo.php,frontend/Show.tsx" \ --agent claude # Get AI-optimized context for resuming work orbit dx task context # Human-readable orbit dx task context -o json # Structured JSON ``` ### Tasks — Dependencies ```bash orbit dx task dep --on # Add dependency orbit dx task deps # Show dependency tree (blocks/blocked-by) orbit dx task deps -o json # JSON output ``` Task statuses: `pending`, `in_progress`, `testing`, `completed`, `blocked`, `cancelled` Task priorities: `low`, `medium`, `high`, `critical` ### Memories ```bash orbit dx mem ls --project # List memories orbit dx mem ls --type architecture # Filter by type orbit dx mem view # View memory content orbit dx mem create --title "Pattern: Repo" --content "..." --project --type patterns orbit dx mem archive # Archive memory ``` Memory types: `architecture`, `patterns`, `bugs`, `domain`, `decisions`, `preferences`, `context` ### Specs ```bash orbit dx spec ls --project # List specs orbit dx spec view # View spec content orbit dx spec create --title "Auth Spec" --content "..." --project orbit dx spec submit # Submit for review orbit dx spec approve # Approve spec orbit dx spec reject # Reject spec orbit dx spec delete # Delete spec ``` Spec statuses: `draft`, `in_review`, `approved`, `rejected` ### Docs ```bash orbit dx doc ls # List all docs orbit dx doc ls --category architecture # Filter by category orbit dx doc toc # Table of contents (no content) orbit dx doc view # View doc by ID orbit dx doc view architecture/overview # View by slug (auto-detected) orbit dx doc create --title "API Guide" --category api --slug api/guide orbit dx doc sync docs.json # Batch sync from JSON file orbit dx doc publish # Publish draft doc orbit dx doc archive # Archive doc orbit dx doc delete # Delete doc ``` Doc categories: `architecture`, `components`, `flows`, `security`, `api`, `infrastructure`, `general` Doc statuses: `draft`, `published`, `archived` **Slug auto-detection:** `doc view` automatically detects whether the argument is a UUID or slug — no `--slug` flag needed (though it's still supported for explicit override). **Batch sync:** `doc sync` accepts a JSON file with an array of doc objects: ```json [{"slug": "api/guide", "title": "API Guide", "content": "...", "category": "api"}] ``` Existing docs (matched by slug) are updated; new slugs are created. ### Sprints ```bash orbit dx sprint ls --project # List sprints orbit dx sprint view # View sprint details orbit dx sprint create --project --name "Sprint 1" --starts-at 2026-03-16 --ends-at 2026-03-30 orbit dx sprint create --project --name "Sprint 2" --starts-at 2026-03-30 --ends-at 2026-04-13 --goal "Ship auth" --velocity-target 20 orbit dx sprint start # Start a sprint orbit dx sprint complete # Complete a sprint orbit dx sprint suggest # AI-powered sprint content suggestions orbit dx sprint velocity --project # Velocity history (last 5 sprints) orbit dx sprint velocity --project --count 10 # More history ``` ### Context Captures ```bash orbit dx capture ls --project # List captures for a project orbit dx capture view # View capture details + payload orbit dx capture webhook --project --source git_commit --payload '{"sha":"abc","message":"fix"}' orbit dx capture persist # Persist capture as a memory ``` Context sources: `git_commit`, `git_pr`, `ci_pipeline`, `deployment`, `code_review`, `manual` ### Knowledge Graph ```bash # Nodes orbit dx graph nodes --project # List nodes orbit dx graph nodes --type module # Filter by type orbit dx graph node # View node details orbit dx graph create-node --project --type module --name "AuthService" orbit dx graph delete-node # Delete a node # Edges orbit dx graph create-edge --from --to --relationship depends_on orbit dx graph delete-edge # Delete an edge # Analysis orbit dx graph impact # Impact analysis (depth 3) orbit dx graph impact --depth 5 # Deeper analysis orbit dx graph subgraph # Local subgraph (depth 2) orbit dx graph paths --from --to # Find paths between nodes orbit dx graph paths --from --to --max-depth 8 ``` ### Task Decomposition ```bash orbit dx decompose create --project --description "Build user auth with JWT" orbit dx decompose create --project --description "..." --spec # With spec context orbit dx decompose ls --project # List decompositions orbit dx decompose view # View decomposition + options orbit dx decompose accept --indexes 0,1,2 # Accept and create tasks from selected options orbit dx decompose reject # Reject decomposition ``` ## Typical Agent Workflow ```bash # 1. Orient orbit dx context -p draxarp --project # 2. Pick up or create task orbit dx task next --project -p draxarp # Or create new orbit dx task focus -p draxarp # One command: assign + start + focus # 3. Work (hooks auto-log progress) # ... edit files, run tests ... # 4. Log key decisions/blockers manually orbit dx task log "Chose X because Y" --tag decision -p draxarp orbit dx task log "Blocked on Z" --tag blocker -p draxarp # 5. Handoff before session ends orbit dx task handoff --done "API done" --remaining "Frontend" --agent claude -p draxarp # 6. Complete orbit dx task complete -p draxarp # 7. Next session picks up with context orbit dx task context -p draxarp ``` ## Configuration Add to `~/.config/orbit/config.yaml`: ```yaml profiles: - name: my-project services: - name: draxarp type: draxarp base_url: https://your-draxarp-instance.com auth: method: token token: "your-api-token" headers: # Optional custom headers X-Tenant: my-tenant-slug # Required for tenant-scoped access ``` For multi-tenant setups, the `X-Tenant` header scopes all API responses to that tenant's workspaces and projects. Tokens can be either platform admin (Sanctum) or tenant user (PAT) tokens. ## Profile Selection Use `-p ` to target a specific profile: ```bash orbit dx proj ls -p draxarp orbit dx task ls -p draxarp --project ``` ## JSON Output All commands support `-o json` for machine-readable output: ```bash orbit dx proj ls -o json orbit dx mem view -o json orbit dx doc toc -o json orbit dx task context -o json orbit dx sprint ls --project -o json orbit dx graph nodes --project -o json ``` ## API Details The orbit CLI communicates with the Draxarp API at: - Intelligence resources: `/api/admin/v1/intelligence/*` (tasks, memories, specs, docs, sprints, graph, captures, decompose) - Platform resources: `/api/admin/v1/*` (projects, workspaces) - Auth: `Authorization: Bearer ` (platform-api or tenant-api Sanctum guard) - Tenant scoping: `X-Tenant: ` header (required for tenant-bound tokens) - Pagination: `{ "success": true, "data": [...], "meta": { "current_page", "last_page", "per_page", "total" } }` - Single resource: `{ "success": true, "data": { ... } }`