Home

Refact Wiki

Documentation for Refact — the open-source, local-first agentic coding engine (refact-lsp engine + IDE plugins + React GUI).

Refact runs a local Rust engine from your IDE and connects only to the providers, local runtimes, and integrations you configure. Use the sidebar, or start below.

Start Here

• Architecture — how the engine, GUI, and IDE plugins fit together
• Quickstart · Installation (VS Code · JetBrains)
• BYOK · Supported Models · Privacy · FAQ · Contributing

Core Agentic

• Agent Modes · Agent Tools
• Task Planner & Cards · Worktrees · Subagents
• Memory & Knowledge · Hidden Roles & Plans · Context Compression
• Scheduler & Cron · Processes & PTY
• Buddy · MCP · Skills, Commands & Hooks · Marketplace

Engine Reference

• Chat System · Providers · Caps & Models
• Code Completion (FIM) · AST · VecDB
• Exec Runtime · HTTP API · Checkpoints & Git · Voice

GUI Reference

• GUI Architecture · State Management · Chat Flow
• Components · Hooks · IDE Integration · Theming

Features & Toolbox

• AI Chat · Context · Agent Getting Started · Agent Rollback · Browser Automation · AI Toolbox

Integrations

• Overview · Chrome · Shell Commands · Command-Line Tool · Command-Line Service
• GitHub · GitLab · Bitbucket · PostgreSQL · MySQL · PDB · JetBrains Troubleshooting