FeverCode

A terminal AI coding portal for builders.
Rust-powered. Full-screen TUI. Workspace-safe. 70 tests passing.

See the Portal


Full-screen terminal UI built with Ratatui โ€” your workspace, at a glance.

fevercode โ€” ~/projects/my-app
โ•ญโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ
โ”‚  Workspace: ~/projects/my-app    Mode: ask    Provider: zai    Agent: builder  โ”‚
โ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ

โ”Œโ”€ Agents โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”Œโ”€ Chat โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  โ— builder              โ”‚  โ”‚                                                                    โ”‚
โ”‚  โ—‹ planner              โ”‚  โ”‚  You: Add error handling to the parse_config function          โ”‚
โ”‚  โ—‹ architect             โ”‚  โ”‚                                                                    โ”‚
โ”‚  โ—‹ reviewer              โ”‚  โ”‚  FeverCode: Analyzed src/config.rs (line 42-78)                   โ”‚
โ”‚  โ—‹ fixer                 โ”‚  โ”‚             Planning 3 changes:                                  โ”‚
โ”‚  โ—‹ explorer              โ”‚  โ”‚             1. Wrap parse() in Result<Config, ConfigError>             โ”‚
โ”‚                          โ”‚  โ”‚             2. Add custom error variants                             โ”‚
โ”‚  [โ†‘โ†“] select  [โŽ] use  โ”‚  โ”‚             3. Update call sites with ? operator                     โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ”‚                                                                    โ”‚
โ”‚  โ”€โ”€ Approval Queue โ”€โ”€                                        โ”‚
โ”‚  [1] src/config.rs  +12 -3   [y/n/e]                     โ”‚
โ”‚                                                                    โ”‚
โ”‚  โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ” โ”‚
โ”‚  โฏ Add error handling to the parse_config function_                โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
TUI Preview โ€” Actual interface rendered in terminal via Ratatui

What's Inside


Built in Rust. Tested. Workspace-scoped. No excuses.

๐Ÿ–ฅ

Full-Screen TUI Available

Full-screen terminal interface built with Ratatui. Chat panel, agent sidebar, approval queue โ€” all keyboard-driven.

๐Ÿ”’

Workspace Safety Available

All operations are sandboxed to your project workspace. No wandering outside. What happens in the workspace stays in the workspace.

โšก

5 Provider Configs Available

Pre-configured for Z.ai, OpenAI, Ollama Local, Ollama Cloud, and Gemini CLI. Set your API key, pick a provider, go.

๐Ÿค–

6 Agent Roles Available

Builder, Planner, Architect, Reviewer, Fixer, Explorer โ€” each agent has a defined role and system prompt.

๐Ÿ”Œ

MCP Stdio Client Available

Model Context Protocol client over stdio. Connect external tool servers to extend FeverCode's capabilities.

โœ…

Patch & Approval Queue Available

Review every change before it lands. Diff view, approve/reject/edit โ€” you stay in control of your codebase.

๐Ÿงช

70 Passing Tests Available

CLI parsing, provider configs, agent definitions, workspace validation โ€” tested and green. Run cargo test yourself.

๐Ÿ“ก

CLI Commands Available

fever, init, doctor, plan, run, endless, providers, agents, version โ€” all wired up.

๐Ÿ“œ

SOULS.md Available

Agent constitution for Ra, Thoth, Ptah, Maat, Anubis, and Seshat souls. Each agent has a defined identity and behavioral contract.

๐ŸŽฏ

Context Economy Available

Output truncation, secret redaction, and session logging. Keep token usage lean without losing critical information.

๐Ÿ”—

Session Continuity Available

JSONL event log and compact summaries. Resume where you left off with full conversation history preserved.

๐Ÿš€

One-line Install Planned

macOS, Linux, and Windows installers. One command to get FeverCode running โ€” pending first release.

๐Ÿ”„

AI Agent Loop Planned

Full autonomous coding loop: prompt โ†’ plan โ†’ execute โ†’ verify โ†’ iterate. The engine that ties it all together.

๐Ÿ“ฆ

Crates.io & Binaries Planned

cargo install fevercode and pre-built binaries for Linux, macOS, Windows. One command, zero friction.

๐Ÿง 

Memory & Context Planned

Persistent memory across sessions. Remember project conventions, past decisions, and your coding preferences.

๐ŸŒ

Browser Tools Planned

Integrated browser automation for web testing, scraping, and UI verification. See your changes rendered live.

Install FeverCode


Choose your platform. One command to get started.

# One-line install (macOS / Linux)
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/FeverDream-dev/FeverCode/releases/latest/download/fever-installer.sh | sh
# One-line install (Windows PowerShell)
powershell -ExecutionPolicy Bypass -c "irm https://github.com/FeverDream-dev/FeverCode/releases/latest/download/fever-installer.ps1 | iex"
# Install from source (all platforms)
cargo install --git https://github.com/FeverDream-dev/FeverCode fever
One-line installers available after the first release. Use source install until then.

โš  No release yet?

Until the first release is published, install from source:

git clone https://github.com/FeverDream-dev/FeverCode
cd FeverCode/fevercode_starter
cargo build --release

Providers


Five provider configurations ready to go. Set the env var, select the provider, start building.

Z.ai

ZAI_API_KEY

Z.ai's coding-optimized models. Default provider.

Configured

OpenAI

OPENAI_API_KEY

GPT-4o and o-series models. Industry standard.

Configured

Ollama Local

OLLAMA_HOST

Run models locally. Zero cost, full privacy. Default: localhost:11434.

Configured

Ollama Cloud

OLLAMA_CLOUD_KEY

Managed Ollama endpoint. Local model quality without local hardware.

Configured

Gemini CLI

GEMINI_API_KEY

Google's Gemini models via CLI integration.

Configured

Safety Modes


Three operating modes. You choose how much autonomy FeverCode gets.

๐Ÿ’ฌ

ask

Ask Mode

Read-only. FeverCode analyzes your code, answers questions, suggests changes โ€” but touches nothing. Safe as a conversation.

โš–

auto

Auto Mode

Proposes changes through the approval queue. Every edit, every file operation passes through your review before applying.

โšก

spray

Spray Mode

Full autonomy within the workspace boundary. FeverCode executes plans, writes code, runs tests โ€” all without waiting for approval.

๐Ÿ›ก

Workspace Boundary โ€” Non-Negotiable

Regardless of mode, FeverCode never operates outside your project directory. No home directory access, no system files, no escapes. The workspace boundary is enforced at the architecture level โ€” not a config flag you can toggle off.

Architecture


The pipeline from prompt to production. Every step is auditable.

๐Ÿ’ฌ
Prompt
โ†’
๐Ÿ“‹
Plan
โ†’
๐Ÿ”
Approval
โ†’
๐Ÿ”ง
Tools
โ†’
โœ…
Checks
โ†’
๐Ÿ“Š
Summary

Roadmap


Where we are. Where we're going.

Foundation Current

CLI skeleton, provider configs, agent role definitions, TUI layout, MCP stdio client, workspace safety boundary, 70 tests passing. This is where we are today.

Agent Loop Next

Wire the full autonomous coding loop: prompt โ†’ plan โ†’ execute โ†’ verify. Connect providers to agent roles. Make the portal actually think and act.

Publishing Next

crates.io publication, pre-built release binaries for Linux/macOS/Windows, homebrew tap. One-command install for everyone.

Memory & Context Future

Persistent memory across sessions. Project conventions, past decisions, coding style preferences โ€” FeverCode remembers.

Extended Tools Future

Browser automation, connected MCP server marketplace, theme customization, notification integrations. The ecosystem expands.