Git-backed deliberation capture for ideas that need time to grow.
Seeds is a CLI tool for capturing thoughts, ideas, and questions with minimal friction, then tracking them through a deliberation lifecycle. Designed for developers and AI-assisted workflows where ideas need time to mature before becoming decisions.
$ seeds jot "What if we used event sourcing instead of CRUD?"
Created seed-a1b2: What if we used event sourcing instead of CRUD?
$ seeds ask "How would this affect our current migration strategy?" --seed seed-a1b2
Created question q-c3d4 on seed-a1b2
$ seeds explore seed-a1b2
seed-a1b2 → exploring
$ seeds create -t "Try event sourcing for the audit log first" --parent seed-a1b2 --type exploration
Created seed-a1b2.1: Try event sourcing for the audit log first
$ seeds resolve seed-a1b2.1
seed-a1b2.1 → resolved
$ seeds answer q-c3d4 "Migration can proceed independently — event sourcing only affects new writes"
Answered q-c3d4
$ seeds resolve seed-a1b2
seed-a1b2 → resolved
# From GitHub
pip install git+https://github.com/outcomesinsights/seeds.git
# Or clone and install locally
git clone https://github.com/outcomesinsights/seeds.git
cd seeds
pip install .Requires Python 3.9+.
seeds init # Creates .seeds/ directoryseeds jot "Quick thought" # Minimal friction capture
seeds create -t "Title" --type idea # Full seed creation with metadata
seeds create -t "Sub-idea" --parent <id> # Create a child seedseeds list # List active seeds
seeds show <id> # Show seed details with questions
seeds tree # Hierarchical view
seeds ready # Seeds ready for attention
seeds blocked # Seeds blocked by unresolved childrenseeds explore <id> # Start actively exploring
seeds defer <id> # Set aside for later
seeds resolve <id> # Mark as resolved
seeds abandon <id> # Decided againstseeds ask "Question?" --seed <id> # Attach a question to a seed
seeds answer <q-id> "The answer" # Answer a question
seeds questions # List open questionsseeds link <id1> <id2> # Create bidirectional relationshipseeds sync --flush-only # Export to .seeds/seeds.jsonl (git-trackable)seeds prime # Output context for AI agentsBeta. Seeds is under active development. The core workflow (capture, explore, resolve) is stable. The CLI interface may evolve.
Seeds includes an experimental web interface for browsing your seeds:
seeds serve # Starts on http://localhost:53365This provides read-only views of your seeds, questions, and their relationships.
Seeds ships a small set of skills for use with Claude Code, distributed as a local plugin. After installing the seeds CLI, run:
seeds skills installThis registers the bundled marketplace and installs the seeds plugin under the seeds:* namespace.
seeds:feedback— frames the next user message as feedback on the agent's prior turn and invites the agent to follow up with its own questions, comments, or criticisms. Useful during deliberation when you want the agent to push back rather than just execute.seeds:seeds-to-beads— frames the user's request as "convert these seeds into beads" and applies the agreed seeds-to-beads conversion principles (separating action from context, mechanically checkable acceptance criteria, etc.) for that one reply.
Re-run seeds skills install after upgrading the seeds CLI to pick up updated skill content.
Seeds was inspired by Steve Yegge's beads project and its core insight: giving AI agents structured tools improves how agents work, bridges AI-human communication, and unlocks AI potential not accessible through unstructured conversation alone.
Issues and pull requests are welcome! See CONTRIBUTING.md for guidelines.