schub 0.1.23 → 0.1.24

package/README.md

@@ -106,7 +106,12 @@ schub proposals pull --proposal-id P0003
 - `schub tickets implement` - Move a ticket to `wip` and launch Opencode.
 - `schub tickets save` - Validate and save one ticket (`--id`) or all local tickets (`--all`) to DB/storage.
 - `schub tickets pull` - Pull tickets from the database into the local `.schub/tickets` folder (requires local `.schub/config.json`).
+- `schub tickets refine` - Refine a ticket using an LLM prompt (`--id`).
 - `schub tickets files` - List local and DB files for a ticket (`--id`).
+- `schub tickets swap --id <ticket> [--attempt <attempt>]` - Swap the repo to a ticket attempt's worktree state.
+- `schub tickets swap --back` - Restore the original repo state after a swap.
+- `schub tickets swap --status` - Show current swap state.
+- `schub tickets merge --id <ticket> [--attempt <attempt>]` - Squash-merge a ticket attempt into the current branch.
 
 ##### Ticket implementation
 
@@ -135,11 +140,45 @@ schub tickets update --id T0004 --id T0005 --status reviewed
 - `--id` (repeatable) selects backlog ticket IDs to move.
 - `--status` sets the target status and must match a project ticket status in DB.
 
+##### Swap, merge, and worktree cleanup
+
+```bash
+# Preview an agent's work
+schub tickets swap --id TK0084 --attempt A0022
+
+# Return to your original branch
+schub tickets swap --back
+
+# Squash-merge an attempt into the current branch
+schub tickets merge --id TK0084 --attempt A0022
+
+# Remove the attempt's worktree after merging
+schub worktree delete --ticket-id TK0084 --attempt A0022
+```
+
 ##### Overview view shortcut
 
 In Overview view, press `s` on a selected backlog or reviewed ticket to open the status modal.
 For backlog tickets choose `Reviewed` or `Archive`. For reviewed tickets choose `Backlog` or `Archive`, then press enter to confirm or esc to cancel.
 
+#### Worktree
+
+- `schub worktree delete --ticket-id <ticket> [--attempt <attempt>]` - Remove a ticket attempt's worktree from disk and git tracking.
+
+#### Setup
+
+- `schub setup --agent <agent>` - Install all skill templates for a coding agent. Supported agents: `opencode`, `claude`, `codex`.
+
+```bash
+schub setup --agent opencode --agent claude --agent codex
+```
+
+Install paths per agent:
+
+- `opencode` → `~/.opencode/skills/<name>/SKILL.md`
+- `claude` → `~/.claude/skills/<name>.md`
+- `codex` → `~/.codex/skills/<name>.md`
+
 #### Templates & Reviews
 
 - `schub templates create --name adr` - Create a new Architectural Decision Record file.