# freecodexyz/free-code

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/freecodexyz-free-code).**

8,509 stars · 2,024 forks · TypeScript

## Links

- GitHub: https://github.com/freecodexyz/free-code
- Homepage: https://x.com/paoloanzn/status/2039022418698907949?s=20
- awesome-repositories: https://awesome-repositories.com/repository/freecodexyz-free-code.md

## Description

Free Code is a terminal-native AI coding agent that edits files, runs shell commands, and answers questions through natural language conversations directly in the command line. It operates as an interactive loop in the shell, providing direct filesystem manipulation without intermediate abstraction layers or sandboxing.

The project distinguishes itself through a compile-time feature flag system that activates or deactivates 54 experimental capabilities, including voice input, multi-agent planning, and memory extraction. It also routes all AI requests to one of five supported API backends by setting a single environment variable, and includes a multi-agent browser-based planning mode that runs autonomous research and planning tasks for 10-30 minutes. The build process strips all telemetry collection and security-prompt guardrails from the original codebase.

The documentation covers installation and configuration for the terminal-native agent loop, the environment-variable-based provider routing mechanism, and the experimental feature flag system.

## Tags

### Artificial Intelligence & ML

- [AI Coding Agent Platforms](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-coding-agent-platforms.md) — Provides a terminal-native AI coding agent that edits files and runs commands through natural language conversations. ([source](https://cdn.jsdelivr.net/gh/freecodexyz/free-code@main/README.md))
- [Experimental Agent Platforms](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-coding-agent-platforms/experimental-agent-platforms.md) — Enables experimental features like multi-agent planning, voice input, and memory extraction for autonomous development tasks.
- [AI Terminal Assistants](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-terminal-assistants.md) — Runs a terminal-native AI coding assistant that executes commands, edits files, and manages development workflows through natural language conversations. ([source](https://x.com/paoloanzn/status/2039022418698907949?s=20))
- [Browser-Based Planning Agents](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-planning/browser-based-planning-agents.md) — Launches a separate browser process to run autonomous multi-agent research and planning tasks for 10-30 minutes.
- [Provider Switching](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/model-integration-serving/model-integration-interfaces/ai-integration-apis/openai-compatible-apis/provider-switching.md) — Routes all AI requests to one of five supported API backends by setting a single environment variable. ([source](https://cdn.jsdelivr.net/gh/freecodexyz/free-code@main/README.md))

### Development Tools & Productivity

- [Interactive Shell Loops](https://awesome-repositories.com/f/development-tools-productivity/shell-environment-integrations/secure-agent-shells/interactive-shell-loops.md) — Runs an interactive loop in the shell that edits files, executes commands, and responds to natural language queries.
- [Compile-Time Feature Toggles](https://awesome-repositories.com/f/development-tools-productivity/compile-time-feature-toggles.md) — Activates or deactivates 54 experimental capabilities by toggling compile-time flags before building the binary.
- [Experimental Feature Flags](https://awesome-repositories.com/f/development-tools-productivity/experimental-feature-flags.md) — Activates all 54 working compile-time feature flags, including voice input, multi-agent planning, and memory extraction. ([source](https://cdn.jsdelivr.net/gh/freecodexyz/free-code@main/README.md))

### System Administration & Monitoring

- [Direct File System Manipulations](https://awesome-repositories.com/f/system-administration-monitoring/system-file-manipulation/direct-file-system-manipulations.md) — Edits project files and runs shell commands directly without intermediate abstraction layers or sandboxing.

### Networking & Communication

- [Environment Variable](https://awesome-repositories.com/f/networking-communication/request-proxies/proxy-routing/environment-variable.md) — Routes all AI requests to one of five supported API backends by reading a single environment variable at runtime.

### Web Development

- [AI Provider Routing](https://awesome-repositories.com/f/web-development/api-endpoint-configurations/service-endpoint-configurations/ai-provider-routing.md) — Routes requests to one of five supported API providers, controlled by a single environment variable.