feat: add persistent task management

.claude-plugin/marketplace.json

@@ -0,0 +1,14 @@
+{
+  "name": "june",
+  "owner": {
+    "name": "Sky"
+  },
+  "plugins": [
+    {
+      "name": "june",
+      "source": "./",
+      "description": "Task-aware workflow skills with persistent state",
+      "version": "1.0.0"
+    }
+  ]
+}

.claude-plugin/plugin.json

@@ -0,0 +1,5 @@
+{
+  "name": "june",
+  "description": "Task-aware workflow skills with persistent state",
+  "version": "1.0.0"
+}

.gitignore

@@ -1,5 +1,6 @@
 .worktrees/
 .gocache/
+.skill-cache/
 
 # Test artifacts
 *.test

CLAUDE.md

@@ -4,6 +4,8 @@
 
 June is a read-only TUI for viewing Claude Code subagent activity. It watches `~/.claude/projects/{project}/agent-*.jsonl` files and displays their transcripts in a terminal interface.
 
+June is also a Claude Code plugin. Run `claude --plugin-dir .` to use june:* skills.
+
 ## Quick Commands
 
 ```bash
@@ -55,6 +57,41 @@ Names always include a unique 4-char ULID suffix. `--name` sets a prefix; if omi
 
 Agent state is stored in `~/.june/june.db` (SQLite).
 
+## Task Commands
+
+Persist tasks across context compaction:
+
+```bash
+# Create root task
+june task create "Implement auth feature"   # Output: t-a3f8b
+
+# Create child tasks
+june task create "Add middleware" --parent t-a3f8b
+
+# Create multiple tasks at once
+june task create "Task 1" "Task 2" "Task 3"
+
+# List root tasks
+june task list
+
+# Show task details and children
+june task list t-a3f8b
+
+# Update task
+june task update t-a3f8b --status in_progress
+june task update t-a3f8b --note "Started work"
+june task update t-a3f8b --status closed --note "Done"
+
+# Delete task (soft delete, cascades to children)
+june task delete t-a3f8b
+
+# JSON output for machine consumption
+june task list --json
+june task create "New task" --json
+```
+
+Tasks are scoped to the current git repo and branch.
+
 ## Coding Conventions
 
 - Follow TDD: write failing test, implement, verify

Makefile

@@ -27,3 +27,24 @@ clean:
 # Build and run the TUI watch
 watch:
 	go build $(LDFLAGS) -o june . && ./june watch
+
+# Superpowers vendoring
+SUPERPOWERS_VERSION := v4.0.3
+SUPERPOWERS_REPO := https://github.com/obra/superpowers
+
+.PHONY: build-skills
+build-skills:
+	@# Fetch superpowers if not cached
+	@[ -d .skill-cache/superpowers ] || git clone $(SUPERPOWERS_REPO) .skill-cache/superpowers
+	@cd .skill-cache/superpowers && git fetch && git checkout $(SUPERPOWERS_VERSION)
+	@# Clean and copy superpowers skills
+	rm -rf skills/
+	cp -r .skill-cache/superpowers/skills skills/
+	@# Overlay June's custom skills (override)
+	cp -r june-skills/* skills/
+	@echo "Skills assembled: superpowers $(SUPERPOWERS_VERSION) + june overrides"
+
+.PHONY: update-superpowers
+update-superpowers:
+	cd .skill-cache/superpowers && git fetch origin main && git log --oneline HEAD..origin/main
+	@echo "Review changes above, then update SUPERPOWERS_VERSION and run 'make build-skills'"

README.md

@@ -58,7 +58,76 @@ Names always include a unique 4-character suffix. The `--name` flag sets a prefi
 | `--model` | Model to use (Codex: `o3`, `o4-mini`; Gemini: `gemini-2.5-pro`, etc.) |
 | `--yolo` | Auto-approve all tool calls (Gemini only) |
 
-Agent state is stored in `~/.june/june.db`.
+## Persistent Tasks
+
+Track tasks that survive context compaction:
+
+```bash
+# Create tasks
+june task create "Implement auth feature"         # Returns: t-a3f8b
+june task create "Subtask 1" --parent t-a3f8b     # Create child task
+
+# View tasks
+june task list                                     # List root tasks
+june task list t-a3f8b                             # Show task details + children
+
+# Update tasks
+june task update t-a3f8b --status in_progress     # Change status
+june task update t-a3f8b --note "WIP: auth flow"  # Add note
+june task update t-a3f8b --title "New title"      # Rename
+
+# Delete (cascades to children)
+june task delete t-a3f8b
+```
+
+Tasks are scoped to the current git repo and branch.
+
+All state is stored in `~/.june/june.db`.
+
+## Claude Code Plugin
+
+June is also a Claude Code plugin providing task-aware workflow skills.
+
+### Installation
+
+**Via marketplace (recommended):**
+```
+/plugin marketplace add sky-xo/june
+/plugin install june@june
+```
+
+**For development:**
+```bash
+git clone https://github.com/sky-xo/june
+cd june
+claude --plugin-dir .
+```
+
+### Skills
+
+June includes all superpowers skills plus customizations:
+
+| Skill | Customization |
+|-------|---------------|
+| `june:writing-plans` | Fresheyes review integration, june task persistence |
+| `june:executing-plans` | June task status tracking, resume after compaction |
+| `june:subagent-driven-development` | Model selection (haiku/opus), conditional code quality review |
+| `june:fresheyes` | Multi-agent code review (Claude/Codex/Gemini) |
+| `june:review-pr-comments` | PR feedback workflow with approval gates |
+
+### Building Skills
+
+To rebuild after editing `june-skills/`:
+
+```bash
+make build-skills
+```
+
+To check for superpowers updates:
+
+```bash
+make update-superpowers
+```
 
 ## How It Works