15-minute setup
Your agent structures GitHub, the graph runs the fleet
You describe a feature in plain language. Your agent (Claude Code, Grok, or Codex) proposes an epic, breaks down sub-tasks, sets blocked-by links and parent/child relations. Roxabi Live reads all of it and computesready, blocked, and done.
1 Pick your agent and install the kit
The roxabi-issues plugin bundles the issue-triage skill. Once installed, the agent activates it on its own when you talk about features, epics, or issue dependencies.
From a terminal, in any repo:
claude plugin marketplace add Roxabi/roxabi-live claude plugin install roxabi-issues
The roxabi-live-marketplace catalog references the plugin and skill. You can invoke /issue-triage explicitly, but in practice the agent triggers it when context calls for it.
Grok is Claude Code compatible with zero extra config: it automatically reads Claude marketplaces, plugins, and skills (xAI docs).
Two equivalent paths:
- Install via Claude Code (commands above), then launch Grok in the same repo.
- Or open the Grok TUI Marketplace tab (
/plugins) and installroxabi-issuesfromRoxabi/roxabi-live.
The skill appears as a slash command. Natural triggers: "create an epic", "block this issue", "break this into sub-tasks".
In the Codex CLI or Codex app:
codex plugin marketplace add Roxabi/roxabi-live codex plugin install roxabi-issues
You can also browse Plugins in the Codex app or run /plugins in the CLI, then install from the marketplace (OpenAI docs).
Codex loads the skill implicitly when your request matches its description, or explicitly via @issue-triage.
2 You describe the feature, the agent structures GitHub
No commands to memorize. Describe the intent; the agent proposes a plan, you approve, it runs the skill in the background.
- #421 · DB schema + migration
- #422 · POST /signup API
- #423 · Registration form + validation
- #424 · E2E signup tests
blocked-by dependencies set. Only #421 is ready for now.What the agent runs in the background (you don't have to)
- Activates the
issue-triageskill installed from the marketplace - Creates the epic with
epictype, size, and priority - Creates each sub-issue as a child of the epic (native GitHub parent/child)
- Sets
blocked-bylinks to sequence the work - Applies size, priority, and lane labels for the cockpit
3 What the graph understands
Two native GitHub relation types are enough. No external board, no Projects V2.
blocked-by: who waits for what
While a blocker is open, the issue stays blocked. When the blocker closes, it becomes ready. That's how you avoid launching agents on incompatible tasks.
Parent / child: epics
The epic groups sub-tasks. The cockpit filters by parent and shows hierarchy in the graph, like the registration example above.
Labels: size, priority, lane
The agent sets them via the skill. You use them in cockpit filters (size:M, P1-high, graph:lane/b, etc.).
4 Connect the Roxabi Live cockpit
- Sign in at app.live.roxabi.dev
- Install the GitHub App on your organization
- Webhooks + reconciliation keep the graph in sync in real time
Open the graph view: issues that are ready with no open blockers are the ones you can hand to an agent right away.
Resources
- Full skill reference (power users)
- Agent & LLM guide
llms.txt