Ginko CLI Skill

Execute ginko commands effectively for session management, task tracking, and knowledge graph operations.

Quick Reference

Need	Command
Start session	`ginko start`
End session	`ginko handoff [message]`
Check progress	`ginko sprint status show <sprintId>`
Mark task done	`ginko task complete <taskId>`
Mark sprint done	`ginko sprint complete <sprintId>`
Search knowledge	`ginko graph query "topic"`
View relationships	`ginko graph explore <nodeId>`
Push to graph	`ginko push`
Pull from dashboard	`ginko pull`
Assign work	`ginko assign <taskId> <email>`

Session Lifecycle

Starting Work

bash

ginko start

•Shows flow state, work mode, active sprint
•Displays "Next up" task based on assignment and status
•Warns about uncommitted files or stale team context

On staleness warning: Auto-run ginko pull to pull team updates.

Ending Work

bash

ginko handoff "summary of what was done"

•Archives session context
•Creates handoff document for continuity

Task & Sprint Status Management

Task Status Flow

code

not_started → in_progress → complete
                ↓
              blocked (with reason)

Critical: Marking Work Complete

Tasks: Update the knowledge graph (syncs to dashboard)

bash

ginko task complete e016_s01_t01
ginko task start e016_s01_t02
ginko task block e016_s01_t03 "waiting for API review"

Sprints: Use sprint command, not task command

bash

ginko sprint complete e016_s01
ginko sprint start e016_s02
ginko sprint pause e016_s01

Verify status:

bash

ginko task show <taskId>      # Shows: ✓ complete, ○ not_started, etc.
ginko sprint status show <sprintId>

Common Pitfall

If dashboard shows tasks as "todo" but ginko graph explore shows checkmarks:

•The graph node has markdown checkmarks but status property wasn't updated
•Fix: Run ginko task complete <taskId> for each task
•This updates the graph property that syncs to dashboard

Cascade Completion

When finishing the last task in a sprint:

bash

ginko task complete e016_s01_t07 --cascade

Auto-completes parent sprint if all tasks done.

Knowledge Graph Queries

Semantic Search

bash

ginko graph query "authentication patterns"
ginko graph query "error handling" --limit 10
ginko graph query "topic" --type ADR

Explore Relationships

bash

ginko graph explore e016_s01        # Sprint and its tasks
ginko graph explore ADR-039         # ADR and connections
ginko graph explore e016_s01_t01    # Task details

Graph Health

bash

ginko graph status    # Node counts, relationships
ginko graph health    # API reliability metrics

Assignment & Team

Assign Tasks

bash

ginko assign e016_s03_t01 user@example.com
ginko assign --sprint e016_s03 --all user@example.com

Push/Pull Sync (ADR-077)

MANDATORY: Use push/pull for all sync operations. Never use deprecated ginko sync or ginko graph load.

bash

# Push local changes to graph
ginko push                        # Push all changes since last push
ginko push epic                   # Push only changed epics
ginko push sprint e001_s01        # Push specific sprint
ginko push charter                # Push charter
ginko push --dry-run              # Preview what would be pushed
ginko push --all                  # Push all content (like graph load)

# Pull dashboard changes to local
ginko pull                        # Pull all changes from dashboard
ginko pull sprint                 # Pull only sprint changes
ginko pull --force                # Overwrite local with graph

# Compare
ginko diff epic/EPIC-001          # Show local vs graph diff
ginko status                      # Show sync state (unpushed/unpulled)

Auto-push: Fires automatically after task/sprint status changes and handoff.

Deprecated commands (still work but show warnings):

•ginko sync → use ginko pull
•ginko graph load → use ginko push --all
•ginko epic --sync → use ginko push epic
•ginko charter --sync → use ginko push charter

Sprint Planning

View Roadmap

bash

ginko roadmap    # Now/Next/Later priority lanes

Sprint Commands

bash

ginko sprint deps              # Visualize task dependencies
ginko sprint start <id>        # Activate sprint
ginko sprint complete <id>     # Mark sprint done
ginko sprint pause <id>        # Temporarily hold

Entity Naming Convention

Entity	Format	Example
Epic	`e{NNN}`	`e016`
Sprint	`e{NNN}_s{NN}`	`e016_s03`
Task	`e{NNN}_s{NN}_t{NN}`	`e016_s03_t01`
Ad-hoc	`adhoc_{YYMMDD}_s{NN}`	`adhoc_260123_s01`

Troubleshooting

Issue	Solution
Task not found	Check ID format matches `e{NNN}_s{NN}_t{NN}`
Sprint won't complete	Use `ginko sprint complete`, not `ginko task complete`
Dashboard out of sync	Run `ginko push` to push local changes, or `ginko task complete` for status
Stale team context	Run `ginko pull` to pull updates
Graph query fails	Check `ginko graph health` for API issues

Common Workflows

Daily Session

•ginko start - Load context, see next task
•ginko task start <id> - Mark task in progress
•Do the work
•ginko task complete <id> - Mark done
•ginko handoff "summary" - End session

Sprint Completion

•Verify all tasks: ginko graph explore <sprintId>
•Complete any unmarked tasks: ginko task complete <taskId>
•Complete sprint: ginko sprint complete <sprintId>
•Verify: ginko sprint status show <sprintId>

Investigate Status Mismatch

•Check graph: ginko graph explore <id>
•Check status: ginko task show <id> or ginko sprint status show <id>
•If mismatch: update with appropriate command
•Verify dashboard reflects changes