Quick Ref / Command

Engineer Kit

/ak:plans-kanban

Plans dashboard

Open AgentKit’s integrated plans dashboard for kanban/grid views, progress tracking, timeline checks, and quick navigation into plan files.

01

Check dashboard status

02

Start if needed

03

Probe capability

04

Open plans route

Rule 01

Thin launcher, not a plan mutation surface

Rule 02

Reuse the integrated AgentKit config dashboard

Rule 03

Capability probe before browser open

Rule 04

Scope-aware plan roots come from dashboard context

Execution Map

Core lanes from input to output, aligned with the command's real execution path.

01

Start

Input, scope, route

  1. 1 Check dashboard status Read ak config status --json and reuse an already-running dashboard URL when another port is active.
  2. 2 Start if needed If no dashboard is running, start the integrated config UI with ak config start --port 8766 --no-open --no-interactive.
02

Work

Agent / skill execution

  1. 3 Probe capability Confirm /api/health lists plans-dashboard or /api/plans responds with a 2xx status before opening the browser.
  2. 4 Open plans route Open http://127.0.0.1:8766/plans, or the status-reported dashboard URL with its existing dir query context.
03

Verify

Gate, review, validation

  1. 5 Review plan views Use multi-plan kanban and grid views, timeline/progress overview, active/completed visibility, and links into plan.md or phase-*.md files.
  2. 6 Respect scope Project dashboards show project-scoped plans only; global dashboards show global-scoped plans only.
04

Close

Report, handoff, artifact

  1. 7 Defer plan mutations Use live ak plan --help for dependency, status, and mutation operations because plans-kanban is only a launcher.

Syntax, arguments, subcommands

How to invoke the skill: syntax, positional arguments, shared options, then each subcommand with its own syntax and outcome.

Syntax

/ak:plans-kanban [--open|--no-open|--stop]

Shared options

--open

Open dashboard

Default or explicit. Finds or starts the dashboard, probes plans support, opens /plans, and prints JSON.

/ak:plans-kanban --open
--no-open

Report URL only

Perform discovery and capability checks, then report the /plans URL without opening a browser.

/ak:plans-kanban --no-open
--stop

Stop dashboard

Delegate to ak config stop and return that command result instead of opening /plans.

/ak:plans-kanban --stop

Sample Prompt

Concrete invocations for each flag, subcommand, mode, or route available in the live workflow.

Open dashboard Recommended
/ak:plans-kanban
Use when:
Use when you want to open the visual plans dashboard.
Expected:
The launcher reuses a running config dashboard or starts one on port 8766, probes plans support, then opens /plans in the browser.
Inspect plan progress
/ak:plans-kanban
Use when:
Use when you need kanban, grid, timeline, or progress views for plans.
Expected:
The integrated dashboard shows active and completed plan visibility with links into plan.md and phase-*.md files.
Stop launcher dashboard
/ak:plans-kanban --stop
Use when:
Use when you need to stop a dashboard instance started by the launcher.
Expected:
The launcher handles --stop for its managed dashboard instead of opening /plans, matching the troubleshooting guidance.

Handled Scope

  • Plans dashboard launch
  • Kanban and grid views
  • Timeline and progress visibility
  • Plan file navigation
  • CLI compatibility probing

Artifacts Produced

Dashboard output

Pattern

http://127.0.0.1:8766/plans or the dashboard URL reported by ak config status --json

The launcher opens the supported plans dashboard, reuses an existing dashboard instance, or reports the exact CLI upgrade/action needed.

Next