Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/sylphxai/flow

πŸš€ AI development platform with MEP architecture - stop writing prompts, start building with 90% less typing
https://github.com/sylphxai/flow

ai automation code-generation developer-tools mcp minimal-effective-prompt semantic-search starcoder2

Last synced: 4 days ago
JSON representation

πŸš€ AI development platform with MEP architecture - stop writing prompts, start building with 90% less typing

Awesome Lists containing this project

README 

          



# πŸš€ Sylphx Flow



> One CLI to rule them all - unified orchestration for Claude Code, OpenCode, and all AI development tools



[![npm](https://img.shields.io/npm/v/@sylphx/flow)](https://www.npmjs.com/package/@sylphx/flow)

[![downloads](https://img.shields.io/npm/dm/@sylphx/flow)](https://www.npmjs.com/package/@sylphx/flow)

[![stars](https://img.shields.io/github/stars/SylphxAI/flow)](https://github.com/SylphxAI/flow)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[![CI](https://github.com/sylphxltd/flow/actions/workflows/ci.yml/badge.svg)](https://github.com/sylphxltd/flow/actions/workflows/ci.yml)



[Get Started](#-installation) β€’ [Documentation](https://flow.sylphx.ai) β€’ [npm](https://www.npmjs.com/package/@sylphx/flow) β€’ [Twitter](https://x.com/SylphxAI)






---



## The Paradigm Shift



### Before Flow: Fragmentation



```bash

# 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



```bash

# 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)



```bash

# Install the omnipotent CLI

npm install -g @sylphx/flow



# That's it. Seriously.

```



### First Invocation



```bash

# 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.



```bash

# 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.**



```bash

# 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

```bash

# 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

```bash

# 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

```bash

# 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:



```bash

# 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:

```bash

$ 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



```typescript

// 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 🀷

```



```bash

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



```bash

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 |



```bash

# 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:**

```bash

sylphx-flow settings

β†’ Select: Agents & Default Agent

```



---



## 🧠 Domain Skills



**25 domain-specific skills with expert-level knowledge built-in.**



Flow includes curated best practices for critical domains. When you work on auth, billing, or security, the AI knows the non-negotiables:



| Category | Skills |

|----------|--------|

| **Security** | `auth`, `account-security`, `security`, `trust-safety`, `privacy` |

| **Payments** | `billing`, `pricing`, `ledger` |

| **Data** | `database`, `data-architecture`, `storage` |

| **Frontend** | `uiux`, `pwa`, `performance`, `seo`, `i18n` |

| **Backend** | `observability`, `operability`, `delivery` |

| **Growth** | `growth`, `referral`, `support`, `admin`, `discovery` |

| **Quality** | `code-quality` |



**Example: Billing skill includes:**

- βœ… Webhook signature verification (non-negotiable)

- βœ… Idempotency with Stripe event IDs

- βœ… Out-of-order webhook handling

- βœ… No dual-write patterns

- βœ… Dunning and failed payment recovery



**Example: Auth skill includes:**

- βœ… Server-enforced authorization (never trust client)

- βœ… Email verification for high-impact actions

- βœ… Graceful SSO provider handling

- βœ… Account recovery best practices



Skills are automatically invoked based on context. The AI asks the right questions and avoids common mistakes.



---



## ⚑ Quick Start



### The Path to Enlightenment



```bash

# 1. Install the meta-CLI

npm install -g @sylphx/flow



# 2. Interactive tutorial (recommended for first-time users)

sylphx-flow quickstart



# 3. Or jump straight in

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



```bash

# 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



```bash

# 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.**



```bash

# 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:



```bash

$ 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:**

```bash

# 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



```bash

# 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.**



```bash

# 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:



```bash

# 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.**



```bash

# 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.**



```bash

# 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.**



```bash

# 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.**



```bash

# 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



```bash

# 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



```bash

# 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



```bash

# 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](https://github.com/sylphxltd/flow/wiki/Installation-&-Setup)** - Complete setup guide

- **[Settings Guide](https://github.com/sylphxltd/flow/wiki/Settings-Guide)** - Master the settings nexus

- **[MEP Design Philosophy](https://github.com/sylphxltd/flow/wiki/MEP-Design-Philosophy)** - Understand the paradigm shift

- **[Technical Architecture](https://github.com/sylphxltd/flow/wiki/Technical-Architecture)** - Deep dive into Flow's internals

- **[CLI Commands](https://github.com/sylphxltd/flow/wiki/CLI-Commands)** - Full command reference

- **[Agent Framework](https://github.com/sylphxltd/flow/wiki/Agent-Framework)** - How agents work

- **[Loop Mode Guide](./packages/flow/LOOP_MODE.md)** - 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](https://huggingface.co/bigcode/starcoder2)** - Revolutionary code tokenization

- **[MCP Protocol](https://modelcontextprotocol.io)** - Standard AI tool integration

- **[Anthropic Claude](https://claude.ai)** - Foundation model

- **[OpenCode](https://github.com/openmcp/opencode)** - Open source alternative

- Open source community ❀️



---



## Packages



| Package | Version | Description |

|---------|---------|-------------|

| [@sylphx/flow](./packages/flow) | [![npm](https://img.shields.io/npm/v/@sylphx/flow)](https://www.npmjs.com/package/@sylphx/flow) | Core CLI - unified orchestration for all AI development tools |



---



## License



MIT License - see [LICENSE](LICENSE) file for details.



---



## Star History



[![Star History Chart](https://api.star-history.com/svg?repos=SylphxAI/flow&type=Date)](https://star-history.com/#SylphxAI/flow&Date)



## Powered by Sylphx



- [@sylphx/biome-config](https://www.npmjs.com/package/@sylphx/biome-config)

- [@sylphx/bump](https://www.npmjs.com/package/@sylphx/bump)

- [@sylphx/doctor](https://www.npmjs.com/package/@sylphx/doctor)



---





Built with ❀️ by Sylphx