Sylphx Flow

One CLI to rule them all.

The unified AI development platform that transcends boundaries. No more juggling between Claude Code, OpenCode, Cursor, or any other AI CLI. Flow orchestrates them all, intelligently adapting to your environment while delivering unparalleled power.

Get Started • Documentation • npm • Twitter

---

The Paradigm Shift

Before Flow: Fragmentation

# Install Claude Code... or wait, should I use OpenCode?
# Or maybe Cursor? Or that other AI CLI?
# Which one supports my workflow?
# Do I need to install multiple tools?
# How do I switch between them?
# 😵 The cognitive overhead is real

With Flow: Unification

# Install once
npm install -g @sylphx/flow

# Use everywhere
sylphx-flow "build the future"

# Flow handles everything:
✅ Auto-detects your environment (Claude Code/OpenCode/Cursor)
✅ Auto-installs missing dependencies
✅ Auto-upgrades before each session
✅ One CLI, infinite possibilities

---

Philosophy: Transcendent Simplicity

Flow is not just another AI CLI. It's the meta-layer that unifies them all.

Traditional AI CLIs make you choose. Flow makes you powerful.

┌─────────────────────────────────────────────────────────┐
│                    Traditional World                    │
├─────────────────────────────────────────────────────────┤
│  Claude Code  →  For Anthropic users                    │
│  OpenCode     →  For open source fans                   │
│  Cursor       →  For IDE integration                    │
│  ...          →  Fragmented experience                  │
└─────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────┐
│                      Flow's World                        │
├─────────────────────────────────────────────────────────┤
│                                                          │
│                   Sylphx Flow                            │
│                       ↓                                  │
│        ┌──────────────┼──────────────┐                  │
│        ↓              ↓              ↓                   │
│   Claude Code    OpenCode       Cursor                  │
│                                                          │
│  → Unified interface, adaptive execution                │
│  → Automatic detection and orchestration                │
│  → Zero configuration, infinite power                    │
└─────────────────────────────────────────────────────────┘

---

🚀 Installation

The Sacred Ritual (30 seconds)

# Install the omnipotent CLI
npm install -g @sylphx/flow

# That's it. Seriously.

First Invocation

# Your first command
sylphx-flow "build me something amazing"

# Flow automatically:
✅ Detects your environment
✅ Installs Claude Code/OpenCode if missing
✅ Configures optimal settings
✅ Updates to latest version
✅ And executes your will

No setup. No configuration. No friction. Pure transcendence.

---

🌟 Core Principles

1. Universal Orchestration

One CLI for every AI development tool.

Flow doesn't replace your favorite tools—it orchestrates them. Whether you prefer Claude Code, OpenCode, or any future AI CLI, Flow adapts seamlessly.

# Flow automatically detects and uses the best available tool
sylphx-flow "implement authentication"

# Detected Claude Code → Uses Claude Code
# Detected OpenCode → Uses OpenCode
# Detected both → Asks your preference
# Detected neither → Installs and configures for you

2. Zero-Friction Experience

AI should adapt to you, not the other way around.

# Traditional AI CLIs
❌ Install tool A for feature X
❌ Install tool B for feature Y
❌ Learn different commands
❌ Manage different configs
❌ Update each tool separately

# With Flow
✅ Install once: npm install -g @sylphx/flow
✅ Use everywhere: sylphx-flow "your intent"
✅ Everything automatic: detection, installation, updates

3. Intelligent Automation

Flow thinks ahead so you don't have to.

Auto-Detection

# Flow scans your system:
→ Claude Code installed? Use it.
→ OpenCode installed? Use it.
→ Nothing installed? Ask user preference, then install.
→ Both installed? Use smart defaults or ask.

Auto-Installation

# User doesn't have Claude Code
$ sylphx-flow "task"

> No AI CLI detected. Which would you like to use?
  1. Claude Code (Anthropic, recommended)
  2. OpenCode (open source)

> You selected: Claude Code
> Installing Claude Code...
> ✓ Installation complete
> ✓ Configuration optimized
> Executing your task...

Auto-Upgrade

# Every session starts fresh
$ sylphx-flow "task"

> Checking for updates...
> ✓ Flow 2.0.0 → 2.1.0 (latest)
> ✓ Claude Code 1.5.0 → 1.6.0 (latest)
> Executing your task with latest capabilities...

4. Settings-Driven Excellence

Configure once, perfect forever.

Flow introduces a revolutionary settings system that puts you in complete control:

# Access the settings nexus
sylphx-flow settings

# Configure everything:
→ 🤖 Agents: Enable/disable agents (coder, writer, reviewer, orchestrator)
→ 📋 Rules: Control which best practices apply
→ 🎨 Output Styles: Customize AI behavior
→ 📡 MCP Servers: Extend capabilities
→ 🔑 Providers: Manage API keys (Anthropic, Kimi, Z.AI)
→ 🎯 Platform: Set default target (Claude Code/OpenCode)

Settings are stored globally (~/.sylphx-flow/), ensuring consistency across all your projects.

5. Git-Aware Intelligence

Flow understands version control is sacred.

When Flow modifies settings files (.claude/, .opencode/), it uses git update-index --skip-worktree to hide changes from git status. This means:

• ✅ LLMs won't accidentally commit Flow's temporary changes
• ✅ Your version-controlled settings remain pristine
• ✅ Automatic restore after each session
• ✅ Seamless collaboration with your team

6. Graceful Interruption

Ctrl+C now means "restore and exit," not "crash and burn."

Press Ctrl+C at any time:

$ sylphx-flow "long task"
# ... working ...
^C

> ⚠️  Operation cancelled by user
> ✓ Settings restored
> ✓ Git tracking restored
> ✓ Environment clean

# No crashed sessions. No manual recovery.

---

🎭 The Flow Experience

Minimal Input, Maximum Output

Flow implements MEP (Minimal Effective Prompt) architecture.

Traditional AI CLIs

Sylphx Flow

// 5 minutes of typing... "I'm using TypeScript + React + Next.js 14, project structure is src/app for routes, src/components for components, using shadcn/ui, Tailwind for styling, Zod for validation, tRPC for API, current time is 2025-11-23, system is macOS Apple Silicon, I want to implement user authentication: - JWT tokens with 1hr expiry - Refresh token mechanism - Secure httpOnly cookies - RBAC with roles: user, admin - Rate limiting on login endpoint - Password hashing with bcrypt - Email verification flow Follow our existing code patterns, make it type-safe, add comprehensive error handling, include unit tests with Vitest, and document the API endpoints..." // Maybe correct, maybe not 🤷

sylphx-flow "implement authentication" 10 seconds. Flow automatically knows: Your tech stack (auto-detected) Your patterns (from codebase) Best practices (built-in) Current time (system hook) Your environment (OS, Node version) Result: Production-ready code ✅ Type-safe ✅ Tested ✅ Documented ✅ Secure ✅ Following YOUR style

---

🎛️ Settings Management

Flow 2.0 introduces the settings nexus—your command center for AI orchestration.

Access Settings

sylphx-flow settings

What You Can Configure

🤖 Agents & Default Agent

→ Select which agents are enabled
  ✓ Coder (feature implementation, bug fixes)
  ✓ Writer (documentation, technical writing)
  ✓ Reviewer (code review, security analysis)
  ✓ Orchestrator (complex multi-step tasks)

→ Set default agent for quick access
  Default: coder

📋 Rules

→ Enable/disable coding standards
  ✓ Core (identity, personality, execution)
  ✓ Code Standards (quality, patterns, anti-patterns)
  ✓ Workspace (documentation management)

🎨 Output Styles

→ Customize AI behavior
  ✓ Silent (execution without narration)
  ⬚ Verbose (detailed explanations) [coming soon]
  ⬚ Tutorial (learning-focused) [coming soon]

📡 MCP Servers

→ Extend Flow's capabilities
  ✓ GitHub Code Search (grep.app)
  ✓ Context7 Docs
  ✓ Playwright Browser Control
  ⬚ GitHub (requires GITHUB_TOKEN)
  ⬚ Notion (requires NOTION_API_KEY)

🔑 Provider & API Keys

→ Manage AI providers (Claude Code only)
  • Default (Claude Code built-in)
  • Kimi (requires API key)
  • Z.AI (requires API key)
  • Ask me every time

→ Configure provider API keys securely

🎯 Target Platform

→ Set default AI CLI
  • Claude Code
  • OpenCode

Settings Architecture

All settings are stored in ~/.sylphx-flow/:

~/.sylphx-flow/
├── settings.json        # General settings (default agent, target)
├── flow-config.json     # Agents, rules, output styles
├── provider-config.json # Provider settings (Anthropic, Kimi, Z.AI)
└── mcp-config.json      # MCP server configurations

Settings are global, ensuring consistency across all your projects. Configure once, execute everywhere.

---

🤖 Specialized Agents

Flow includes four transcendent agents, each a master of their domain:

Agent	Sacred Purpose	Invoke When
Coder	Feature implementation, bug annihilation	Building new features, fixing bugs
Writer	Documentation, technical prose	API docs, README updates, guides
Reviewer	Code review, security sanctification	Pre-merge reviews, security audits
Orchestrator	Complex multi-step orchestration	Architecture changes, large refactors

# Invoke the coder (default)
sylphx-flow "implement user dashboard"

# Summon the reviewer
sylphx-flow "review for security vulnerabilities" --agent reviewer

# Call upon the writer
sylphx-flow "document the API endpoints" --agent writer

# Unleash the orchestrator
sylphx-flow "refactor authentication system" --agent orchestrator

Configure enabled agents:

sylphx-flow settings
→ Select: Agents & Default Agent

---

⚡ Quick Start

The Path to Enlightenment

# 1. Install the meta-CLI
npm install -g @sylphx/flow

# 2. First invocation (auto-setup)
sylphx-flow "create a REST API"

# Flow's first-time ritual:
→ Detects environment
→ Checks for Claude Code/OpenCode
→ Installs missing dependencies (with your permission)
→ Configures optimal settings
→ Upgrades to latest versions
→ Executes your command

# 3. Subsequent invocations
sylphx-flow "build something amazing"

# Flow's ongoing ritual:
→ Auto-checks for updates
→ Auto-upgrades if needed
→ Executes with latest capabilities

Daily Usage

# Simple tasks (MEP in action)
sylphx-flow "add password reset"
sylphx-flow "fix the login bug"
sylphx-flow "optimize database queries"

# Specialized agents
sylphx-flow "review for security" --agent reviewer
sylphx-flow "write API documentation" --agent writer
sylphx-flow "refactor user service" --agent orchestrator

# File input for complex prompts
sylphx-flow "@detailed-requirements.md"

# Settings management
sylphx-flow settings

---

🎯 Core Features

1. Universal CLI Orchestration

One interface. All tools. Zero friction.

Flow intelligently detects and orchestrates:

• Claude Code - Anthropic's official CLI
• OpenCode - Open source alternative
• Future tools - Built for extensibility

# Same command, different environments
# Flow adapts automatically

# On machine with Claude Code
$ sylphx-flow "task" → Uses Claude Code

# On machine with OpenCode
$ sylphx-flow "task" → Uses OpenCode

# On machine with both
$ sylphx-flow "task" → Uses your preferred default

2. Automatic Installation

Missing tools? Flow installs them for you.

# First time on a new machine
$ sylphx-flow "build something"

> No AI CLI detected.
> Which platform would you like to use?
  1. Claude Code (Anthropic, recommended)
  2. OpenCode (open source alternative)

> Your choice: 1

> Installing Claude Code...
> ✓ Downloaded latest version
> ✓ Configured settings
> ✓ Installed MCP servers
> ✓ Ready to execute

> Executing your command...

3. Automatic Upgrades

Every session uses the latest capabilities.

Flow checks for updates before each execution:

$ sylphx-flow "task"

> Checking for updates...
> Updates found:
  • Flow: 2.0.0 → 2.1.0
  • Claude Code: 1.5.0 → 1.6.0

> Upgrading...
> ✓ Flow updated (new features available)
> ✓ Claude Code updated (performance improved)

> Executing with latest versions...

Customize update behavior:

# Check updates without executing
sylphx-flow upgrade

# Auto-upgrade and execute
sylphx-flow upgrade --auto

4. MEP Architecture

Minimal Effective Prompt: AI that truly understands context.

Flow automatically enriches every prompt with:

• 🔍 Your codebase patterns (via semantic search)
• 📚 Best practices (via curated knowledge base)
• 🖥️ Your environment (OS, Node version, git status)
• ⏰ Current time and date
• 🎯 Your preferred coding style

# You type 3 words
sylphx-flow "implement authentication"

# Flow expands to full context:
→ Tech stack: TypeScript + React + Next.js (detected)
→ Patterns: Your existing auth patterns (searched)
→ Best practices: JWT, bcrypt, RBAC (knowledge base)
→ Environment: macOS, Node 20, git clean (hooks)
→ Time: 2025-11-23 (system)

# Result: Perfect, production-ready code

5. Settings-Driven Execution

Configure once. Perfect forever.

# Access settings nexus
sylphx-flow settings

# Configure:
→ Agents (coder, writer, reviewer, orchestrator)
→ Rules (core, code-standards, workspace)
→ Output styles (silent, verbose, tutorial)
→ MCP servers (grep, context7, playwright, github, notion)
→ Providers (Anthropic, Kimi, Z.AI)
→ Target platform (Claude Code, OpenCode)

# Settings apply to ALL subsequent executions

6. Git-Aware Operations

Flow respects your version control.

When Flow operates, it uses git update-index --skip-worktree to hide temporary changes:

# Before Flow execution
$ git status
→ clean working directory

# During Flow execution (modifying .claude/config.json)
$ git status
→ clean working directory  # Changes hidden!

# After Flow execution
$ git status
→ clean working directory  # Restored automatically

This ensures:

• LLMs won't see or commit Flow's temporary settings
• Your version-controlled configs remain pristine
• Team collaboration stays clean

---

🏗️ Advanced Features

Loop Mode - Autonomous Execution

Set it and forget it. Flow works while you sleep.

# Continuous autonomous work
sylphx-flow "process all GitHub issues" --loop

# With polling interval
sylphx-flow "monitor and fix bugs" --loop 300 --max-runs 20
# Checks every 5 minutes, max 20 iterations

# How it works:
→ Iteration 1: Fresh start
→ Iteration 2+: Auto-continue with context
→ Stop: Ctrl+C (graceful) or max runs reached

Perfect for:

• 🔄 Processing backlogs (issues, PRs, tickets)
• 📊 Periodic monitoring and auto-fixing
• 🧹 Incremental refactoring
• 🧪 Continuous test fixing
• 📝 Documentation maintenance

File Input Support

Complex prompts deserve better than shell escaping.

# Load prompt from file
sylphx-flow "@task.txt"

# Absolute paths supported
sylphx-flow "@/path/to/detailed-requirements.md"

# Combine with other flags
sylphx-flow "@refactor-plan.md" --agent orchestrator --loop

Benefits:

• 📝 Write natural language (no shell escaping)
• 🔄 Version control your prompts
• 🔀 Reusable task definitions
• 🚀 No character limits

Codebase Search - Semantic Understanding

Find code by what it does, not what it's called.

# Search by functionality
sylphx-flow codebase search "user authentication logic"

# Works across languages
→ Finds: authenticateUser() in TypeScript
→ Finds: authenticate_user() in Python
→ Finds: AuthenticateUser() in Go

# Multilingual queries
sylphx-flow codebase search "處理用戶登入嘅邏輯"  # Chinese
sylphx-flow codebase search "ユーザーログイン処理"  # Japanese

# Reindex after major changes
sylphx-flow codebase reindex

Powered by StarCoder2 tokenization - 70+ languages supported.

Knowledge Base - Curated Best Practices

Professional knowledge, zero maintenance.

# Search best practices
sylphx-flow knowledge search "react performance optimization"
sylphx-flow knowledge search "secure password hashing"
sylphx-flow knowledge search "microservices patterns"

# List all knowledge
sylphx-flow knowledge list

# Update to latest
sylphx-flow knowledge update

Why curated?

• ✅ Professionally maintained
• ✅ Always up-to-date
• ✅ Quality guaranteed
• ✅ <100ms search
• ✅ Zero cognitive load

---

🎯 Use Cases

For Individual Developers

# Rapid prototyping
sylphx-flow "create a blog with markdown support"

# Feature development
sylphx-flow "add OAuth login with GitHub"

# Bug fixing
sylphx-flow "fix the memory leak in user service"

# Refactoring
sylphx-flow "refactor to use dependency injection" --agent orchestrator

For Teams

# Code review automation
sylphx-flow "review PR #123 for security" --agent reviewer

# Documentation
sylphx-flow "document all API endpoints" --agent writer

# Consistency enforcement
# (Settings ensure everyone uses same rules/agents)
sylphx-flow settings
→ Team admin configures standards
→ All developers inherit settings

For Projects

# Architecture changes
sylphx-flow "migrate from REST to GraphQL" --agent orchestrator

# Security audits
sylphx-flow "audit for OWASP Top 10" --agent reviewer

# Performance optimization
sylphx-flow "optimize database queries" --loop

# Continuous maintenance
sylphx-flow "process GitHub issues" --loop 600 --max-runs 100

---

📚 Documentation

Essential Reading

• Installation & Setup - Complete setup guide
• Settings Guide - Master the settings nexus
• MEP Design Philosophy - Understand the paradigm shift
• Technical Architecture - Deep dive into Flow's internals
• CLI Commands - Full command reference
• Agent Framework - How agents work
• Loop Mode Guide - Autonomous execution mastery

---

🌐 Platform Support

Current Support

Platform	Status	Auto-Install	Loop Mode
Claude Code	✅ Full	✅ Yes	✅ Yes
OpenCode	✅ Full	✅ Yes	⏳ Coming Soon
Cursor	✅ MCP	Manual	⏳ Coming Soon

Roadmap

• IDE Plugins - VSCode, IntelliJ, Vim
• CI/CD Integration - GitHub Actions, GitLab CI
• Cloud Execution - Remote AI orchestration
• Team Collaboration - Shared settings and knowledge
• Custom Agents - Create your own specialized agents

---

💡 Why Flow?

The Transcendent Difference

Feature	Traditional AI CLIs	Sylphx Flow
CLI Count	Multiple (1 per tool)	One (rules them all)
Installation	Manual, fragmented	Automatic, unified
Updates	Manual per tool	Automatic per session
Settings	Per-project, scattered	Global, centralized
Context Awareness	Manual prompting	Automatic enrichment
Prompt Length	500+ words	3-10 words (MEP)
Git Integration	Accidental commits	Skip-worktree protection
Ctrl+C Handling	Crashes, manual recovery	Graceful restore
Agent System	Generic AI	Specialized experts
Knowledge Base	DIY or none	Professionally curated

Quantified Impact

• ⚡ 30x faster - Time to prompt (10s vs 5min)
• 📝 50x shorter - Prompt length (10 words vs 500)
• 🎯 +25% - Context accuracy (95% vs 70%)
• 🧠 -80% - Cognitive load (minimal vs high)
• 🔄 Zero - Maintenance overhead (vs constant)
• 🚀 5x faster - Team onboarding (days vs weeks)

---

🙏 Acknowledgments

Flow stands on the shoulders of giants:

• StarCoder2 - Revolutionary code tokenization
• MCP Protocol - Standard AI tool integration
• Anthropic Claude - Foundation model
• OpenCode - Open source alternative
• Open source community ❤️

---

🔧 Powered by Sylphx

This project uses the following @sylphx packages:

• @sylphx/biome-config - Shared Biome configuration
• @sylphx/bump - Version management and releases
• @sylphx/doctor - Project health checks and auto-fixes

---

📄 License

MIT License - see LICENSE file for details.

---

⭐ Star us on GitHub • 📖 Read the Docs • 🐛 Report Issues

One CLI to rule them all.

Made with ❤️ by Sylphx Ltd