An AI-powered terminal that never forgets your context, integrates with your project management, and costs nothing beyond your existing Claude Max subscription.

• 🤖 Claude Code Integration - Free AI with your Claude Max subscription
• 🧠 Unlimited Context - Intelligent compression for endless sessions
• 📊 ProjectPulse Integration - Issues, wiki, knowledge base at your fingertips
• 🎨 Droid Theme - Beautiful dark UI with semantic colors

• Agent Mode - Natural language to commands (# find all TODO comments)
• Auto-Detection - Intelligently detects when you want AI help
• Sequential Thinking - Break down complex problems step-by-step
• Error Explanation - AI explains errors in plain English

• Auto-Compression - Automatically compresses at 150K tokens
• Manual Compression - Cmd+Shift+C when you want
• Anchored Summaries - Key decisions preserved across sessions
• Rolling Summary - Never lose important context

Coming soon...

• macOS 12+ (Monterey or later)
• Claude Code CLI installed
• (Optional) Ollama for local context compression

# Download latest release
# Coming soon...

# Clone repository
git clone https://github.com/yourusername/flowterminal.git
cd flowterminal

# Install dependencies
task install

# Development mode
task dev

# Production build
task build

{
    "ai:provider": "claudecode",
    "ai:claudecode:model": "claude-sonnet-4",
    "ai:claudecode:tools": ["Edit", "Bash", "Read", "Write"]
}

{
    "context:compression:enabled": true,
    "context:compression:threshold": 150000,
    "context:summary:provider": "ollama",
    "context:summary:model": "qwen2.5:3b"
}

{
    "mcp:servers": {
        "sequential-thinking": {
            "command": "npx",
            "args": ["-y", "@anthropic/mcp-sequential-thinking"]
        },
        "projectpulse": {
            "transport": "http",
            "url": "http://localhost:3001/mcp"
        }
    }
}

FlowTerminal uses a hybrid approach built on Wave Terminal v0.12+:

┌─────────────────────────────────────────────────────────────┐
│         Wave Terminal v0.12+ (INHERITED)                    │
│  AI Chat Panel, Multi-modal, wsh ai, File Tools, Presets   │
└─────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────┐
│         FlowTerminal Extensions (8 weeks)                   │
│  Claude CLI Provider, Compression MW, MCP, Droid Theme     │
└─────────────────────────────────────────────────────────────┘

What we build:

• Claude Code CLI Provider (Go) - Subprocess integration with Claude CLI
• Compression Middleware (Go) - Token tracking and intelligent compression
• MCP Client (Go) - Tool integration (Sequential Thinking, ProjectPulse)
• Droid Theme (CSS) - Custom dark theme

What we inherit:

• AI Chat slide-out panel
• Multi-modal input (images, PDFs)
• wsh ai CLI command
• File write with diff preview
• AI presets configuration

See FEATURE_SPEC.md for detailed technical documentation.

• Wave Terminal v0.12+ fork setup
• Claude Code CLI provider
• Disable Wave credits
• Droid theme

• Context compression middleware
• Token counting & monitoring
• Anchor preservation (decisions, code)

• MCP client (stdio + HTTP)
• Sequential Thinking MCP
• ProjectPulse MCP

• Testing & bug fixes
• Documentation
• Release v1.0

Contributions welcome! Please read our contributing guidelines (coming soon).

Apache 2.0 - See LICENSE for details.

Based on Wave Terminal (Apache 2.0).

• Wave Terminal - The amazing terminal we're built on
• Anthropic - For Claude and the Claude Code CLI
• ProjectPulse - Project management integration