CodeClub IDE

Offline-first AI IDE for coding, project management, and vector design. Bring your own keys, keep data local, and choose the AI provider per conversation.

Author: Ignacio Agustin Angelone, Argentina
Website: codeclubide.com
Donate: Ko-fi

Quick Start

vp install
vp run dev

What CodeClub Is

CodeClub IDE is a local-first desktop app built with Electron, React 19, TypeScript, and a Rust helper engine. It has no telemetry and does not proxy AI traffic. Requests go directly from the user's device to the configured provider.

The product has three clear modes:

• Coding Mode: file explorer, Monaco editor, integrated terminal, debugger, graph view, and AI agent panel.
• Studio Mode: local table workspace stored as CSV in .codeclub/data/ with schema in .codeclub/studio.json.
• Design Mode: vector design surface with layers, shapes, freehand drawing, text, fills, strokes, shadows, components, instances, Yoga auto-layout, design tokens, Figma import, and PNG/JSX/CSS export.

AI Providers

Supported providers:

• OpenAI
• Anthropic Claude
• Google Gemini
• Ollama
• LM Studio
• OpenRouter-compatible flows where configured in the app

Provider choice is per conversation. Local providers work without cloud API keys.

Agent Capabilities

• Workspace skills from .agents/skills/<name>/SKILL.md.
• Plan and todo tracking inside the agent workflow.
• Swarm subagents, up to 4 concurrent workers.
• Checkpoints and rollback for chat and file state.
• Persistent workspace memory.
• RAG blocks for saved snippets.
• AST/topographic read, edit, search, diff, and graph tools.
• Atomic tool chains for bounded file operations.

Architecture

src/main/          Electron main process, IPC, filesystem, terminal, debug, indexer
src/preload/       Safe renderer API exposed through contextBridge
src/renderer/src/  React UI, Monaco/xterm surfaces, AI tools, modes
src/shared/        Shared types and pure design/topographic logic
rust-engine/       Native helper for scan, search, AST/topographic tools, exec, DAP
resources/bin/     Prebuilt helper binaries used by the app in development
docs/              User and AI-facing documentation
.agents/skills/    Workspace-local skills

For the compact technical map, read docs/PROJECT_INDEX.md.

Development

Use Vite+ (vp) as the unified project command runner.

vp install
vp run dev
vp check
vp build
vp test
vp run cargo:build
vp run package:win
vp run package:linux
vp run package:mac

The repository still exposes compatibility scripts in package.json; prefer vp for checks, tests, build, and package script execution. Before completing programming work, run:

npm run typecheck
vp check

Local Indexing

The app opens a workspace through indexing:open, creates .codeclub/codeclub.json, scans indexable source/documentation files, trains the local Word2Vec model, and stores embeddings in Electron userData/indices/<workspace-hash>/.

Excluded directories include dot-folders, node_modules, out, dist, build, coverage, .cache, .next, .nuxt, target, tree-sitter-vendored, references, and plan. Lockfiles are skipped.

Requirements

Requirement	Notes
OS	Windows, macOS, Linux
Node.js	Vite+ managed runtime is recommended
Package manager	npm is configured by devEngines
Rust	Needed when rebuilding rust-engine
wasm-pack	Needed when rebuilding the WASM renderer

Documentation

• AGENTS.md: repo instructions for AI agents.
• docs/PROJECT_INDEX.md: current product and architecture map.
• CONTRIBUTING.md: contribution flow and DCO sign-off.
• SECURITY.md: private vulnerability reporting.
• CHANGELOG.md: release notes.

Privacy

CodeClub does not proxy, log, or store provider traffic. API keys are supplied by the user and requests go directly to the configured provider or local endpoint.

Licensing

Dual model:

License	Use case	Cost
AGPLv3	Personal, educational, academic, research	Free
Commercial	Enterprise, corporate, SaaS, for-profit	Paid

See LICENSE. Commercial inquiries: iangel.oned@gmail.com.

Contributions require DCO sign-off. See CONTRIBUTING.md.