idea storer (is)

Lightning-fast CLI for capturing development ideas that AI coding agents can understand.

Features

• Instant capture: is "my idea" - that's it
• AI-ready: Ideas stored in .ideas.json that AI agents can read
• Project-aware: Ideas stay with your project (or go global)
• Fast: Written in Rust, starts in milliseconds
• Cross-platform: Windows, macOS, Linux

Installation

From Releases (Recommended)

macOS/Linux:

curl -fsSL https://github.com/byigitt/ideastorer/releases/latest/download/is-installer.sh | sh

Windows (PowerShell):

irm https://github.com/byigitt/ideastorer/releases/latest/download/is-installer.ps1 | iex

From Source (Before First Release)

macOS/Linux:

curl -fsSL https://raw.githubusercontent.com/byigitt/ideastorer/main/scripts/is-installer.sh | sh

Windows (PowerShell):

irm https://raw.githubusercontent.com/byigitt/ideastorer/main/scripts/is-installer.ps1 | iex

From Cargo

cargo install ideastorer

Quick Start

# Add your first idea
is "implement user authentication"

# Add with tags and priority
is add "fix mobile nav" -t bug,urgent -p high

# View your ideas
is list

# Search ideas
is search "auth"

# Mark as done
is done abc123  # Use idea ID (partial works)

# Export for backup
is export -o backup.json

Commands

Options

• -g, --global: Use global storage instead of project-local
• --json: Output as JSON for scripting
• -p, --priority: Set priority (low, medium, high)
• -t, --tag: Add tags (comma-separated)

AI Agent Integration

Install the skill for your AI coding agent:

npx add-skill byigitt/ideastorer

This enables your AI assistant to:

• Read your ideas when you ask "What should I work on?"
• Suggest related tasks based on stored ideas
• Help track progress and mark ideas complete

Supports: Claude Code, Cursor, OpenCode, Codex, Copilot, and 14+ more agents.

Storage

Ideas are stored in .ideas.json:

• Project-local (default): In current directory or git root
• Global (--global):
  • Linux/macOS: ~/.config/ideastorer/ideas.json
  • Windows: %APPDATA%\ideastorer\ideas.json

JSON Format

{
  "version": "1.0.0",
  "ideas": [
    {
      "id": "abc12345",
      "content": "implement caching",
      "tags": ["performance"],
      "priority": "high",
      "status": "active",
      "created_at": "2024-01-15T10:30:00Z",
      "context": {
        "project": "myapp",
        "git_branch": "main"
      }
    }
  ]
}

Shell Completions

# Bash
is completions bash >> ~/.bashrc

# Zsh
is completions zsh >> ~/.zshrc

# Fish
is completions fish > ~/.config/fish/completions/is.fish

# PowerShell
is completions power-shell >> $PROFILE

Why IDEA Storer?

Ever had a great idea while deep in code? Instead of:

• Losing it in a TODO comment
• Forgetting it by the time you finish
• Switching to another app

Just type is "my idea" and keep coding. Your AI assistant can find it later.

Development

# Clone
git clone https://github.com/byigitt/ideastorer
cd ideastorer

# Build
cargo build --release

# Test
cargo test

# Install locally
cargo install --path .

License

MIT - See LICENSE for details.

Contributing

Contributions welcome! Please read CONTRIBUTING.md first.