Back to Details

draxarp

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Draxarp Intelligence — orbit CLI

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:
别名：
dx
orbit draxarp
（或
orbit dx
）命令用于管理Draxarp开发智能模块——这是LLM辅助开发的第二大脑。它涵盖九种资源类型：

Resources

资源类型

ResourceAliasDescription
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
资源别名描述
project
proj
智能项目——用于分组任务、规格说明、记忆库和文档
task
—开发任务，包含状态、优先级、活动日志、工作交接、聚焦状态和依赖关系
memory
mem
持久化知识——包括模式、Bug、决策、领域上下文
spec
—带有审核流程的规格说明（草稿→审核→通过/驳回）
doc
—技术文档，支持基于别名的寻址和维基链接
sprint
—迭代周期规划，包含速度跟踪和AI内容建议
capture
cap
上下文捕获——包括Git提交、PR、CI事件、部署记录
graph
kg
知识图谱——节点、边、影响分析、子图、路径查找
decompose
—基于AI的任务分解，从描述生成子任务

Quick Reference

快速参考

Projects

项目管理

bash
orbit dx proj ls                              # List projects
orbit dx proj view <id>                       # View project details
orbit dx proj create --name "My Project"      # Create project
orbit dx proj delete <id>                     # Delete project
bash
orbit dx proj ls                              # 列出项目
orbit dx proj view <id>                       # 查看项目详情
orbit dx proj create --name "My Project"      # 创建项目
orbit dx proj delete <id>                     # 删除项目

Tasks — Core CRUD

任务——核心增删改查

bash
orbit dx task ls --project <id>               # List tasks for a project
orbit dx task ls --status in_progress         # Filter by status
orbit dx task ls --type epic --project <id>   # List only epics
orbit dx task ls --parent <epic-id>           # List children of an epic
orbit dx task view <id>                       # View task details + last 5 activity logs
orbit dx task create --title "Fix bug" --project <id> --priority high
orbit dx task create --title "Wire frontend" --project <id> --depends-on <blocker-id>
orbit dx task create --title "Auth" --project <id> --type epic      # Create an epic
orbit dx task create --title "JWT" --project <id> --type story --parent <epic-id>  # Story under epic
orbit dx task update <id> --status testing --activity "Running PHPUnit"
orbit dx task assign <id> --assignee claude   # Assign task
orbit dx task start <id>                      # Set status to in_progress
orbit dx task complete <id>                   # Mark completed (with guard checks)
orbit dx task delete <id>                     # Delete task
orbit dx task epic <id>                       # Show epic progress (% complete, children)
Task types: 
task
(default), 
epic
, 
story
bash
orbit dx task ls --project <id>               # 列出指定项目的任务
orbit dx task ls --status in_progress         # 按状态筛选
orbit dx task ls --type epic --project <id>   # 仅列出史诗任务
orbit dx task ls --parent <epic-id>           # 列出史诗任务的子任务
orbit dx task view <id>                       # 查看任务详情及最近5条活动日志
orbit dx task create --title "Fix bug" --project <id> --priority high
orbit dx task create --title "Wire frontend" --project <id> --depends-on <blocker-id>
orbit dx task create --title "Auth" --project <id> --type epic      # 创建史诗任务
orbit dx task create --title "JWT" --project <id> --type story --parent <epic-id>  # 史诗任务下的用户故事
orbit dx task update <id> --status testing --activity "Running PHPUnit"
orbit dx task assign <id> --assignee claude   # 分配任务
orbit dx task start <id>                      # 将状态设置为进行中
orbit dx task complete <id>                   # 标记任务完成（包含校验检查）
orbit dx task delete <id>                     # 删除任务
orbit dx task epic <id>                       # 显示史诗任务进度（完成百分比、子任务情况）
任务类型：
task
（默认）、
epic
、
story

Tasks — Focus & Next (session management)

任务——聚焦与下一个任务（会话管理）

bash
orbit dx task focus <id>                      # One command: assign + start + set focus
orbit dx task focus <id> --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 <id>             # Next available task by priority (skips epics & blocked)
bash
orbit dx task focus <id>                      # 一键操作：分配+开始+设置聚焦
orbit dx task focus <id> --agent claude       # 指定Agent（默认：claude）
orbit dx task current                         # 显示当前聚焦的任务
orbit dx task current --agent claude          # 查看指定Agent的当前聚焦任务
orbit dx task next --project <id>             # 按优先级获取下一个可用任务（跳过史诗任务和被阻塞任务）

Tasks — Activity Logs

任务——活动日志

bash
orbit dx task log <id> "Implemented API endpoints" --tag progress
orbit dx task log <id> "Blocked on DB schema" --tag blocker --agent claude
orbit dx task log <id> "Chose approach A over B" --tag decision
orbit dx task logs <id>                       # List all logs (newest first)
orbit dx task logs <id> --tag blocker         # Filter by tag
orbit dx task logs <id> --limit 10            # Limit results
orbit dx task logs <id> -o json               # JSON output
Activity log tags: 
progress
, 
blocker
, 
decision
, 
hypothesis
, 
tried
, 
result
, 
handoff
, 
note
bash
orbit dx task log <id> "Implemented API endpoints" --tag progress
orbit dx task log <id> "Blocked on DB schema" --tag blocker --agent claude
orbit dx task log <id> "Chose approach A over B" --tag decision
orbit dx task logs <id>                       # 列出所有日志（最新的在前）
orbit dx task logs <id> --tag blocker         # 按标签筛选
orbit dx task logs <id> --limit 10            # 限制结果数量
orbit dx task logs <id> -o json               # 输出JSON格式
活动日志标签：
progress
、
blocker
、
decision
、
hypothesis
、
tried
、
result
、
handoff
、
note

Tasks — Structured Handoffs & Context

任务——结构化工作交接与上下文

bash
undefined
bash
undefined

Record a handoff (session continuity)

记录工作交接（保持会话连续性）

orbit dx task handoff <id>
--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
orbit dx task handoff <id>
--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

获取AI优化的上下文信息，用于恢复工作

orbit dx task context <id> # Human-readable orbit dx task context <id> -o json # Structured JSON
undefined
orbit dx task context <id> # 人类可读格式 orbit dx task context <id> -o json # 结构化JSON格式
undefined

Tasks — Dependencies

任务——依赖关系

bash
orbit dx task dep <id> --on <blocking-task-id>    # Add dependency
orbit dx task deps <id>                            # Show dependency tree (blocks/blocked-by)
orbit dx task deps <id> -o json                    # JSON output
Task statuses: 
pending
, 
in_progress
, 
testing
, 
completed
, 
blocked
, 
cancelled
Task priorities: 
low
, 
medium
, 
high
, 
critical
bash
orbit dx task dep <id> --on <blocking-task-id>    # 添加依赖关系
orbit dx task deps <id>                            # 显示依赖树（阻塞/被阻塞）
orbit dx task deps <id> -o json                    # 输出JSON格式
任务状态：
pending
、
in_progress
、
testing
、
completed
、
blocked
、
cancelled
任务优先级：
low
、
medium
、
high
、
critical

Memories

记忆库

bash
orbit dx mem ls --project <id>                # List memories
orbit dx mem ls --type architecture           # Filter by type
orbit dx mem view <id>                        # View memory content
orbit dx mem create --title "Pattern: Repo" --content "..." --project <id> --type patterns
orbit dx mem archive <id>                     # Archive memory
Memory types: 
architecture
, 
patterns
, 
bugs
, 
domain
, 
decisions
, 
preferences
, 
context
bash
orbit dx mem ls --project <id>                # 列出记忆库
orbit dx mem ls --type architecture           # 按类型筛选
orbit dx mem view <id>                        # 查看记忆库内容
orbit dx mem create --title "Pattern: Repo" --content "..." --project <id> --type patterns
orbit dx mem archive <id>                     # 归档记忆库
记忆库类型：
architecture
、
patterns
、
bugs
、
domain
、
decisions
、
preferences
、
context

Specs

规格说明

bash
orbit dx spec ls --project <id>               # List specs
orbit dx spec view <id>                       # View spec content
orbit dx spec create --title "Auth Spec" --content "..." --project <id>
orbit dx spec submit <id>                     # Submit for review
orbit dx spec approve <id>                    # Approve spec
orbit dx spec reject <id>                     # Reject spec
orbit dx spec delete <id>                     # Delete spec
Spec statuses: 
draft
, 
in_review
, 
approved
, 
rejected
bash
orbit dx spec ls --project <id>               # 列出规格说明
orbit dx spec view <id>                       # 查看规格说明内容
orbit dx spec create --title "Auth Spec" --content "..." --project <id>
orbit dx spec submit <id>                     # 提交审核
orbit dx spec approve <id>                    # 通过审核
orbit dx spec reject <id>                     # 驳回审核
orbit dx spec delete <id>                     # 删除规格说明
规格说明状态：
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 <id>                        # 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 <id>                     # Publish draft doc
orbit dx doc archive <id>                     # Archive doc
orbit dx doc delete <id>                      # 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.
bash
orbit dx doc ls                               # 列出所有文档
orbit dx doc ls --category architecture       # 按分类筛选
orbit dx doc toc                              # 目录（不含内容）
orbit dx doc view <id>                        # 通过ID查看文档
orbit dx doc view architecture/overview       # 通过别名查看（自动识别）
orbit dx doc create --title "API Guide" --category api --slug api/guide
orbit dx doc sync docs.json                   # 从JSON文件批量同步
orbit dx doc publish <id>                     # 发布草稿文档
orbit dx doc archive <id>                     # 归档文档
orbit dx doc delete <id>                      # 删除文档
文档分类：
architecture
、
components
、
flows
、
security
、
api
、
infrastructure
、
general
文档状态：
draft
、
published
、
archived
别名自动识别：
doc view
会自动识别参数是UUID还是别名——无需
--slug
标志（不过仍支持显式覆盖）。
批量同步：
doc sync
接受包含文档对象数组的JSON文件：
json
[{"slug": "api/guide", "title": "API Guide", "content": "...", "category": "api"}]
已存在的文档（通过别名匹配）会被更新；新别名会创建新文档。

Sprints

迭代周期

bash
orbit dx sprint ls --project <id>             # List sprints
orbit dx sprint view <id>                     # View sprint details
orbit dx sprint create --project <id> --name "Sprint 1" --starts-at 2026-03-16 --ends-at 2026-03-30
orbit dx sprint create --project <id> --name "Sprint 2" --starts-at 2026-03-30 --ends-at 2026-04-13 --goal "Ship auth" --velocity-target 20
orbit dx sprint start <id>                    # Start a sprint
orbit dx sprint complete <id>                 # Complete a sprint
orbit dx sprint suggest <id>                  # AI-powered sprint content suggestions
orbit dx sprint velocity --project <id>       # Velocity history (last 5 sprints)
orbit dx sprint velocity --project <id> --count 10  # More history
bash
orbit dx sprint ls --project <id>             # 列出迭代周期
orbit dx sprint view <id>                     # 查看迭代周期详情
orbit dx sprint create --project <id> --name "Sprint 1" --starts-at 2026-03-16 --ends-at 2026-03-30
orbit dx sprint create --project <id> --name "Sprint 2" --starts-at 2026-03-30 --ends-at 2026-04-13 --goal "Ship auth" --velocity-target 20
orbit dx sprint start <id>                    # 启动迭代周期
orbit dx sprint complete <id>                 # 完成迭代周期
orbit dx sprint suggest <id>                  # AI生成的迭代周期内容建议
orbit dx sprint velocity --project <id>       # 速度历史（最近5个迭代周期）
orbit dx sprint velocity --project <id> --count 10  # 更多历史记录

Context Captures

上下文捕获

bash
orbit dx capture ls --project <id>            # List captures for a project
orbit dx capture view <id>                    # View capture details + payload
orbit dx capture webhook --project <id> --source git_commit --payload '{"sha":"abc","message":"fix"}'
orbit dx capture persist <id>                 # Persist capture as a memory
Context sources: 
git_commit
, 
git_pr
, 
ci_pipeline
, 
deployment
, 
code_review
, 
manual
bash
orbit dx capture ls --project <id>            # 列出指定项目的上下文捕获记录
orbit dx capture view <id>                    # 查看上下文捕获详情及负载
orbit dx capture webhook --project <id> --source git_commit --payload '{"sha":"abc","message":"fix"}'
orbit dx capture persist <id>                 # 将捕获记录持久化为记忆库
上下文来源：
git_commit
、
git_pr
、
ci_pipeline
、
deployment
、
code_review
、
manual

Knowledge Graph

知识图谱

bash
undefined
bash
undefined

Nodes

节点

orbit dx graph nodes --project <id> # List nodes orbit dx graph nodes --type module # Filter by type orbit dx graph node <id> # View node details orbit dx graph create-node --project <id> --type module --name "AuthService" orbit dx graph delete-node <id> # Delete a node
orbit dx graph nodes --project <id> # 列出节点 orbit dx graph nodes --type module # 按类型筛选 orbit dx graph node <id> # 查看节点详情 orbit dx graph create-node --project <id> --type module --name "AuthService" orbit dx graph delete-node <id> # 删除节点

Edges

边

orbit dx graph create-edge --from <id> --to <id> --relationship depends_on orbit dx graph delete-edge <id> # Delete an edge
orbit dx graph create-edge --from <id> --to <id> --relationship depends_on orbit dx graph delete-edge <id> # 删除边

Analysis

分析

orbit dx graph impact <node-id> # Impact analysis (depth 3) orbit dx graph impact <node-id> --depth 5 # Deeper analysis orbit dx graph subgraph <node-id> # Local subgraph (depth 2) orbit dx graph paths --from <id> --to <id> # Find paths between nodes orbit dx graph paths --from <id> --to <id> --max-depth 8
undefined
orbit dx graph impact <node-id> # 影响分析（深度3） orbit dx graph impact <node-id> --depth 5 # 更深层次的分析 orbit dx graph subgraph <node-id> # 局部子图（深度2） orbit dx graph paths --from <id> --to <id> # 查找节点间的路径 orbit dx graph paths --from <id> --to <id> --max-depth 8
undefined

Task Decomposition

任务分解

bash
orbit dx decompose create --project <id> --description "Build user auth with JWT"
orbit dx decompose create --project <id> --description "..." --spec <spec-id>  # With spec context
orbit dx decompose ls --project <id>          # List decompositions
orbit dx decompose view <id>                  # View decomposition + options
orbit dx decompose accept <id> --indexes 0,1,2  # Accept and create tasks from selected options
orbit dx decompose reject <id>                # Reject decomposition
bash
orbit dx decompose create --project <id> --description "Build user auth with JWT"
orbit dx decompose create --project <id> --description "..." --spec <spec-id>  # 结合规格说明上下文
orbit dx decompose ls --project <id>          # 列出任务分解记录
orbit dx decompose view <id>                  # 查看任务分解及选项
orbit dx decompose accept <id> --indexes 0,1,2  # 接受并从选中选项创建任务
orbit dx decompose reject <id>                # 拒绝任务分解

Typical Agent Workflow

典型Agent工作流

bash
undefined
bash
undefined

1. Orient

1. 定位上下文

orbit dx context -p draxarp --project <id>
orbit dx context -p draxarp --project <id>

2. Pick up or create task

2. 领取或创建任务

orbit dx task next --project <id> -p draxarp # Or create new orbit dx task focus <task-id> -p draxarp # One command: assign + start + focus
orbit dx task next --project <id> -p draxarp # 或创建新任务 orbit dx task focus <task-id> -p draxarp # 一键操作：分配+开始+聚焦

3. Work (hooks auto-log progress)

3. 工作（钩子自动记录进度）

... edit files, run tests ...

... 编辑文件、运行测试 ...

4. Log key decisions/blockers manually

4. 手动记录关键决策/阻塞点

orbit dx task log <id> "Chose X because Y" --tag decision -p draxarp orbit dx task log <id> "Blocked on Z" --tag blocker -p draxarp
orbit dx task log <id> "Chose X because Y" --tag decision -p draxarp orbit dx task log <id> "Blocked on Z" --tag blocker -p draxarp

5. Handoff before session ends

5. 会话结束前进行工作交接

orbit dx task handoff <id> --done "API done" --remaining "Frontend" --agent claude -p draxarp
orbit dx task handoff <id> --done "API done" --remaining "Frontend" --agent claude -p draxarp

6. Complete

6. 完成任务

orbit dx task complete <id> -p draxarp
orbit dx task complete <id> -p draxarp

7. Next session picks up with context

7. 下一次会话通过上下文恢复工作

orbit dx task context <id> -p draxarp
undefined
orbit dx task context <id> -p draxarp
undefined

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"
添加到
~/.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"

Profile Selection

配置文件选择

Use 
-p <profile>
to target a specific profile:
bash
orbit dx proj ls -p draxarp
orbit dx task ls -p draxarp --project <id>
使用
-p <profile>
指定目标配置文件：
bash
orbit dx proj ls -p draxarp
orbit dx task ls -p draxarp --project <id>

JSON Output

JSON输出

All commands support 
-o json
for machine-readable output:
bash
orbit dx proj ls -o json
orbit dx mem view <id> -o json
orbit dx doc toc -o json
orbit dx task context <id> -o json
orbit dx sprint ls --project <id> -o json
orbit dx graph nodes --project <id> -o json
所有命令均支持
-o json
以生成机器可读的输出：
bash
orbit dx proj ls -o json
orbit dx mem view <id> -o json
orbit dx doc toc -o json
orbit dx task context <id> -o json
orbit dx sprint ls --project <id> -o json
orbit dx graph nodes --project <id> -o json

API Details

API详情

The orbit CLI communicates with the Draxarp API at:
  • Base path: 
    /api/v1/intelligence
  • Auth: 
    Authorization: Bearer <token>
    (jwt, platform-api, or tenant-api guard)
  • Pagination: 
    { "success": true, "data": [...], "meta": { "current_page", "last_page", "per_page", "total" } }
  • Single resource: 
    { "success": true, "data": { ... } }
orbit CLI与Draxarp API的通信地址：
  • 基础路径：
    /api/v1/intelligence
  • 认证：
    Authorization: Bearer <token>
    （jwt、platform-api或tenant-api守卫）
  • 分页：
    { "success": true, "data": [...], "meta": { "current_page", "last_page", "per_page", "total" } }
  • 单个资源：
    { "success": true, "data": { ... } }