FineCode

FineCode gives you one workflow for code quality and developer tooling across CLI, IDE, CI, and AI assistants.

What FineCode Solves

• Unifies tool execution across local CLI, IDE, CI and AI
• Keeps tooling config reusable via presets
• Supports multi-project workspaces
• Isolates tooling dependencies in dedicated virtual environments

Prerequisites

• Python 3.11-3.14 or uv

Quick Start (5 minutes)

1. Add dependencies and FineCode config to pyproject.toml:

[dependency-groups]
dev_workspace = ["finecode==0.3.*", "fine_python_recommended==0.3.*"]

[tool.finecode]
presets = [{ source = "fine_python_recommended" }]

2. Bootstrap and activate the dev_workspace environment:

# Recommended: bootstrap the environment
pipx run finecode bootstrap
# or
uvx finecode bootstrap

# macOS/Linux
source .venvs/dev_workspace/bin/activate
# Windows (PowerShell)
.venvs\dev_workspace\Scripts\Activate.ps1
# Windows (cmd.exe)
.venvs\dev_workspace\Scripts\activate.bat

3. Prepare environments and run FineCode:

python -m finecode prepare-envs
python -m finecode run lint

4. (Optional, but recommended) Enable FineCode in development environments you use:

• IDE (VSCode): IDE Integration docs and FineCode VSCode extension
• AI assistants (MCP): MCP setup
• Git hooks: Use the same actions in local/CI/hooks workflows

For full setup and recommended presets, see: Getting Started

Documentation

• Start here
• Concepts
• CLI
• Configuration
• IDE Integration (LSP, VSCode, MCP)
• Guide: Creating an Extension
• Guide: Creating a Preset
• Guide: Multi-Project Workspace
• Reference: Built-in Actions
• Reference: Extensions

Contributing

See Development for local development workflow.

License

MIT