FEVERDREAM Logo

FEVERDREAM
Open Source

FeverCode

Code like fever. Ship like dream.

An open-source terminal coding agent for Linux, built with Rust.

View on GitHub All Open Source
fevercode — ~/repos/project
$ fever code
Initializing FeverCode v0.1.0...
Loading workspace: ./project
Analyzing repository structure...
Found 24 files, 3 crates, 2 modules
Role: coder | Mode: plan
─────────────────────────────────
✔ Ready. Type your task or :help for commands.
$ _
fevercode — agent session
> Refactor auth module to use JWT tokens
● Planning...
├ Analyzing src/auth.rs (142 lines)
├ Analyzing src/session.rs (87 lines)
└ 3 changes identified
● Executing 1/3 Update JWT validation
→ Writing src/auth.rs... done
● Executing 2/3 Update session store
→ Writing src/session.rs... done
● Verifying
→ cargo check ✓ passed
→ cargo test ✓ 12/12 passed
─────────────────────────────────
✓ Complete. 2 files modified, all tests passing.

What is FeverCode?

FeverCode is a CLI/TUI-first coding agent that runs in your terminal. It understands your local repository, reads and edits files, runs shell commands and tests, and helps you complete real software work end-to-end — all from the comfort of your terminal.

Rust 98% MIT / Apache-2.0 9 Crates Linux First

Architecture

A modular crate structure designed for extensibility and clean separation of concerns.

fever-cli fever-tui fever-agent fever-core fever-tools Shell · FS · Git fever-providers OpenAI · Ollama fever-config TOML fever-search DuckDuckGo fever-browser Chrome MCP

Current Status

Transparent development progress. Here's what works, what's cooking, and what's coming.

Working Now

  • CLI entry points (fever, fever code, fever version, fever roles, fever config)
  • Core Tools (shell, filesystem, git, grep)
  • TUI with panels (chat, plan, tasks, tool log, browser)
  • TOML configuration system
  • 10+ specialist roles

In Progress

  • LLM integration (OpenAI + Ollama)
  • Agent loop (plan → execute → verify → iterate)
  • Chat input system

Planned

  • Chrome MCP integration
  • Streaming responses
  • Session persistence
  • Additional LLM providers

Capabilities

Repo Awareness

Opens any repository and understands its structure, file tree, and codebase layout automatically.

Code Search

Full-text grep across the codebase with fast, regex-aware search capabilities.

Safe Editing

Reads and writes files with care, preserving structure and providing clear diffs.

Shell Execution

Runs shell commands, captures output, and integrates results into the workflow.

Git Operations

Branch management, diffing, commit history, and status tracking built in.

Specialist Roles

10+ roles including coder, researcher, architect, debugger, tester, and reviewer.

Specialist Roles

FeverCode operates in focused specialist modes for different tasks.

coderCode implementation
researcherInformation gathering
plannerStrategic planning
architectSystem design
debuggerTroubleshooting
testerQuality assurance
reviewerCode review
refactorerCode improvement
shell_executorCommand execution
git_operatorGit operations

Built With

Rust

Core language — performance, safety, reliability

ratatui

Terminal user interface framework

crossterm

Cross-platform terminal control

tokio

Async runtime for concurrent operations

clap

CLI argument parsing

Linux

Primary target platform

fever-search

DuckDuckGo web search

fever-browser

Chrome MCP integration

Configuration

Simple TOML-based configuration. Set your defaults, providers, and models in one place.

config.toml ~/.config/fevercode/
TOML 
[defaults]
provider = "openai"
model = "gpt-4o"
temperature = 0.7
max_tokens = 4096

[providers.openai]
enabled = true
api_key = "your-api-key"

[providers.ollama]
enabled = true
base_url = "http://localhost:11434"

Installation

Terminal 
# Clone the repository
git clone https://github.com/FeverDream-dev/FeverCode.git
cd FeverCode

# Build from source
cargo build --release

# Start the TUI
fever
Usage 
# Start the TUI
fever
# or
fever code

# List available roles
fever roles

# Show configuration
fever config

# Show version
fever version

Philosophy

Honest

No fake claims. If something doesn't work, we say so.

Terminal-First

Optimized for Linux terminal usage. No GUI dependency.

Practical

Real tools that do real work, not abstractions.

Focused

A tight core loop, not a sprawling platform.

Extensible

Clean interfaces for adding providers and tools.

More from Fever Dream

All Open Source

View our complete open-source portfolio

Get in Touch

Talk to us about collaboration

Budgie

Another open-source project from Fever Dream