@ship-cli/opencode
v0.2.3
Published
OpenCode plugin for Ship - Linear task management integration
Downloads
1,118
Maintainers
Readme
@ship-cli/opencode
OpenCode plugin for Ship - Linear task management and stacked changes for AI coding agents.
Installation
Add to your opencode.json:
{
"plugins": ["@ship-cli/opencode"]
}Prerequisites
What It Provides
This plugin exposes the ship tool to OpenCode, enabling AI agents to:
Task Management
| Action | Description |
|--------|-------------|
| ready | Find tasks with no blockers |
| list | List all tasks with optional filters |
| blocked | List tasks waiting on dependencies |
| show | View task details |
| start | Mark task as in progress |
| done | Mark task as complete |
| create | Create new tasks |
| update | Modify task properties |
| block | Add task dependency |
| unblock | Remove task dependency |
| relate | Link related tasks |
| status | Check ship configuration status |
Stacked Changes (jj)
| Action | Description |
|--------|-------------|
| stack-create | Create isolated workspace for a task |
| stack-describe | Update commit message (use title + description params for multi-line) |
| stack-sync | Fetch and rebase onto trunk |
| stack-restack | Rebase stack onto trunk (no fetch) |
| stack-submit | Push and create/update PR |
| stack-status | View current change info |
| stack-log | View stack of changes |
| stack-squash | Squash change into parent |
| stack-abandon | Abandon a change |
| stack-up | Navigate to parent change |
| stack-down | Navigate to child change |
| stack-undo | Undo last jj operation |
| stack-update-stale | Fix stale working copy |
| stack-bookmark | Create or move bookmark |
| stack-workspaces | List all workspaces |
| stack-remove-workspace | Remove a workspace |
PR Reviews
| Action | Description |
|--------|-------------|
| pr-reviews | Fetch PR reviews in AI-friendly format |
Webhooks
| Action | Description |
|--------|-------------|
| webhook-daemon-status | Check webhook daemon status |
| webhook-subscribe | Subscribe to PR events |
| webhook-unsubscribe | Unsubscribe from events |
| webhook-cleanup | Remove stale subscriptions |
Milestones
| Action | Description |
|--------|-------------|
| milestone-list | List project milestones |
| milestone-show | View milestone details |
| milestone-create | Create new milestone |
| milestone-update | Modify milestone |
| milestone-delete | Delete milestone |
| task-set-milestone | Assign task to milestone |
| task-unset-milestone | Remove task from milestone |
Skill Integration
For best results, pair this plugin with the ship-cli skill which provides workflow guidance:
.opencode/skill/ship-cli/SKILL.mdThe skill teaches the agent the proper workflow:
- Find ready tasks
- Create isolated workspaces
- Make changes and sync
- Submit PRs with proper context
