Command Palette

Search for skills, repositories, subagents, rules, or tags

Impersonate User

Select a user to impersonate

Sync Repository

Select a repository to sync

Delete Repository

Select a repository to delete

Introducing FerixCode

A powerful CLI for development with Ralph loops. Built on top of Claude, Cursor & OpenCode.

Experimental

Run Autonomously

Start a task and step away. Perfect for long-running jobs that complete while you're AFK.

Provider Agnostic

Works with Claude, Cursor, and OpenCode. Use your preferred AI provider with a single flag.

End-to-End Workflows

From task to PR in one command. Create branches, run tests, and open pull requests automatically.

Yolo mode is enabled by default. All work runs on an isolated git worktree. Use --no-yolo to require permission prompts.
Installation
npm i -g ferix-code

Install ferix-code globally with npm

Quick Start
ferix "Add auth to my app"

Run your first task with a simple command

CLI Options
-i, --iterations <n>Max iterations
-c, --verify <commands...>Verify commands
--branch <name>Create branch
--pushPush to remote
--prCreate PR
--provider <name>LLM provider
--no-yoloRequire permission prompts (yolo mode is default)
-d, --debugEnable debug logging to .ferix/logs/

All available command-line flags

Basic Task
ferix "Add user authentication"

Describe what you want in plain English

With Verification
ferix "Fix login bug" -c "bun test" -c "bun lint"

Run tests and linting after completion

Autonomous Loop
ferix "Refactor the API layer" -i 10

Run multiple iterations for complex refactoring

Full Workflow
ferix "Add dark mode support" \
  --branch feat/dark-mode \
  --push --pr

Create a branch and open a pull request

From PRD
ferix "Complete all tasks in PRD.md"

Complete tasks from a structured specification file

Provider Choice
ferix "Add caching layer" --provider cursor

Use Claude, Cursor, or OpenCode as the LLM

How It Works
01SetupCreate session → Setup worktree → Capture base branch
02DiscoverySpawn fresh LLM → Break down task → Generate session name
03IterationBuild prompt → Spawn fresh LLM → Parse signals → Update plan
04CompletionCommit changes → Push branch → Create PR

The Ferix loop follows a structured flow: setup, discovery, iteration, and completion

Pure RALPH
while :; do cat PROMPT.md | claude ; done

The original pattern: same prompt piped to Claude in a bash loop

Ferix Loop
ferix run --iterations 5 --verify 'bun test'

Enhanced RALPH with orchestration, signals, and git isolation

Key Differences
AspectPure RALPHFerix Loop
PromptStatic fileDynamic with plan state
ContextCodebase onlyPlan + signals
IsolationNoneGit worktree
TrackingManualStructured phases

How Ferix extends the pure RALPH pattern

GitHub

Ferix

X