Independent open-source project. Not affiliated with or endorsed by Anthropic. Claude and Claude Code are trademarks of Anthropic.

luicode is a local gateway that runs your favorite coding agents against a unified catalog of provider models — free tiers, subscriptions, and local servers — from one configurable proxy with a browser-admin UI.

What You Get

• 55 ToS-friendly providers. 1.3B+ free tokens every month. Use free, paid, subscription, and local models from one searchable UI without putting your account at risk. luicode follows provider terms and removes integrations if they stop being allowed.
• 10 coding agents. One model catalog. Run Claude Code, Codex, Pi, OpenCode, Cline, Hermes, DeepSeek Harness, Grok Build, Muse Code, or Aider with your luicode models.
• Keep coding through provider outages. After retries are exhausted, luicode automatically tries your next configured model without making you restart the turn—across every client.
• Up to 90% fewer terminal-output tokens. Optional RTK filters common command output, while five luicode optimizations handle quota probes, command-prefix detection, titles, suggestions, and filepaths without calling a provider.
• Native Code sessions in your browser. Choose a folder and run Codex in the browser with real-time and background support. Freely switch providers/models in the same session. Support for switching harnesses in the same session coming soon!
• Terminal, desktop, IDE, or phone. Work through native launchers, VS Code, Codex App, JetBrains, Discord, or Telegram.
• Voice notes in. Code out. Talk to your agent using local Whisper or NVIDIA NIM transcription.
• Agent capabilities stay intact. Stream responses, use tools, preserve native interleaved thinking for maximum performance, send images, and route Fable, Opus, Sonnet, and Haiku independently with compatible models.
• Browser automation (optional). Enable the browser extra to give coding agents the ability to navigate, click, fill forms, and extract data from web pages using Chrome DevTools Protocol — powered by the same engine as JEV-Ultrafast.

Free-tier availability and limits are controlled by each provider and may change.

How It Works

luicode runs one local gateway process (luicode-server). Coding agents connect to it through luicode-* launchers or IDE/app integrations, and it routes every request in the catalog to the provider and model you picked — with fallbacks, reasoning control, and token-saving optimizations applied in between.

Quick Start

1. Install

macOS / Linux

curl -fsSL "https://raw.githubusercontent.com/Luigibarte4563/luicode/main/scripts/install.sh" | sh

Windows PowerShell

& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Luigibarte4563/luicode/main/scripts/install.ps1")))

Android (Termux)

Install Termux from F-Droid first, then run this single command:

curl -fsSL "https://raw.githubusercontent.com/Luigibarte4563/luicode/main/scripts/install.sh" | sh

That is the whole install. The installer detects Termux automatically and:

• updates the Termux package lists and installs only the packages you are missing (python, git, curl)
• checks that Python is new enough for LUICode (3.14 or newer)
• keeps the source checkout in ~/.luicode-src — never in ~/.luicode, which holds your configuration and data
• installs LUICode into that checkout with pip install -e .
• adds the directory holding luicode and luicode-server to your PATH from ~/.bashrc or ~/.zshrc, inside a single managed # >>> LUICode PATH >>> block so reruns never duplicate it
• verifies that both commands run, and prints the web interface URL

Open a new Termux session afterwards. Then:

luicode-server

See docs/android.md for persistence, wake locks, LAN access, and how to update or uninstall.

Note: coding agents (Claude Code, Codex, OpenCode, …) are installed separately with the Linux installer described above; the Termux one-command install covers the gateway itself. termux-wake-lock is never run for you — the installer only prints it as an optional tip.

See docs/android.md for complete Android/Termux setup including persistence, wake locks, and LAN access.

When prompted, choose at least one coding agent and optionally RTK. You can review the installers before running them: install.sh and install.ps1.

Optional: Enable browser automation for web interaction capabilities (not available on Android):

uv sync --extra browser

This installs browser-harness and cdp-use for Chrome DevTools Protocol automation.

2. Start luicode

Windows

Open luicode from your desktop or Start menu.

macOS

Open luicode from your desktop or Applications folder.

Linux

Run:

luicode-server

Android (Termux)

Open a new Termux session, then run:

luicode-server

luicode is an alias for the same server, so either works.

For background persistence, acquire a wake lock and disable battery optimization:

termux-wake-lock
luicode-server

The server listens on port 8082 by default, so the Admin UI is at http://127.0.0.1:8082/admin. Change it with PORT in ~/.luicode/.env.

See docs/android.md for auto-start (Termux:Boot), notifications (Termux:API), and LAN access.

luicode opens the Admin UI after starting. On Windows and macOS, use the tray or menu-bar icon to open Admin, restart, or quit. On Android, use termux-open-url to open the Admin UI. When using luicode-server, keep its terminal open.

3. Configure NVIDIA NIM

1. Create an API key at build.nvidia.com/settings/api-keys.
2. Open the Admin UI URL from the server log.
3. Paste the key into NVIDIA_NIM_API_KEY.
4. Leave MODEL on the default nvidia_nim/nvidia/nemotron-3-super-120b-a12b, or search the model dropdown and select another model.
5. Click Apply.

To protect the local proxy with a bearer token, enable Proxy Authentication in Admin.

4. Run Your Coding Agent

Claude Code:

luicode-claude

Codex:

luicode-codex

Pi:

luicode-pi

OpenCode 2:

luicode-opencode

To upgrade from OpenCode 1, rerun the luicode installer with OpenCode selected. It upgrades the native installation in ~/.opencode/bin; for npm or other package managers, follow OpenCode's migration instructions first. For npm v1, run npm uninstall -g opencode-ai, then rerun the luicode installer. Close OpenCode before upgrading. OpenCode manages its own data upgrades.

RTK integration is temporarily unavailable for OpenCode 2. RTK continues to work with the other supported agents.

Use luicode-opencode for coding and sessions. Use plain opencode for commands such as upgrades, service management, ACP, and MCP setup.

Cline:

luicode-cline

Hermes:

luicode-hermes

DeepSeek Harness Web:

luicode-dsh

Grok Build:

luicode-grok

Muse Code:

luicode-muse

Aider:

luicode-aider

Choose A Provider

1. Open a provider link below for its key, models, or setup instructions.
2. In the Admin UI, configure the listed setting. For OpenAI / ChatGPT subscription access, use Providers → OAuth providers instead.
3. Search the MODEL dropdown and select a model. If the provider cannot list models, enter <provider-id>/<exact-provider-model-id> manually.
4. Click Apply.

Optional: add an ordered Fallback Models list under Model config. It applies to every connected client. A failed request may reach and consume usage from more than one provider before succeeding.

ollama pull llama3.1
ollama serve

Connect Your Client

For terminal use, start luicode-server, then run luicode-claude, luicode-codex, luicode-pi, luicode-opencode, luicode-cline, luicode-hermes, luicode-dsh, luicode-grok, luicode-muse, or luicode-aider.

For editor and app integrations, install the client, start luicode, then open Admin UI → Integrations and click Connect on its card.

• Claude Code in VS Code — install the Claude Code extension.
• Claude Desktop — install Claude Desktop. Fully quit it before connecting or disconnecting, then reopen it. Disconnect returns to normal Claude sign-in.
• Codex in VS Code and App — install the Codex extension or Codex App.
• Claude Code in JetBrains ACP — install Claude Agent in JetBrains AI Assistant and start it once, then click Connect in luicode. Reopen the IDE, select Claude Code (LUICODE), and start a new chat. After JetBrains updates the agent, restart luicode before starting a new chat. Requires a local IDE in its standard installation locations.

Reload VS Code or restart the app/IDE after connecting. In Codex and Claude Desktop, select a luicode model from the model picker. luicode keeps connected integrations up to date when it starts; reload or restart the client when luicode reports updated settings. Use Disconnect on the same card to remove the integration.

Run luicode on the same computer and in the same user environment as the client you are configuring.

Optional Integrations

Configure integrations from Admin UI → Messaging, then click Apply.

Messaging commands

curl -fsSL "https://raw.githubusercontent.com/Luigibarte4563/luicode/main/scripts/install.sh" | sh -s -- --voice-local

curl -fsSL "https://raw.githubusercontent.com/Luigibarte4563/luicode/main/scripts/install.sh" | sh -s -- --voice-local --torch-backend cu130

& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Luigibarte4563/luicode/main/scripts/install.ps1"))) -VoiceLocal

& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Luigibarte4563/luicode/main/scripts/install.ps1"))) -VoiceLocal -TorchBackend cu130

# With the browser extra
uv sync --extra browser

from luicode.application.browser_tools.ports import BrowserToolsPort


# In your handler/service
async def my_handler(browser_tools: BrowserToolsPort):
    await browser_tools.navigate("https://example.com")
    state = await browser_tools.observe()
    # state.elements contains indexed interactive elements
    await browser_tools.click(node_id=5)  # Click the 5th element
    await browser_tools.fill(node_id=3, text="search query")
    await browser_tools.wait()

Manage Your Installation

Run luicode-server --version to check the installed version without starting luicode.

Update

Stop all running luicode commands, then run:

luicode-update

This installs from the main branch, so you always get the newest code. If you prefer to stay on a published release, run luicode-upgrade instead: it installs the newest release tag and pins you to it, and tells you when you are already on it.

luicode-upgrade

Pinned installations receive fixes only when the next release is published, so luicode-update warns you that it is moving you back to main.

For local voice support, include --voice-local (macOS/Linux) or -VoiceLocal (Windows), plus your --torch-backend or -TorchBackend option if used.

If your installation does not have luicode-update or luicode-upgrade yet, run the installer once to add them.

Muse Code on native Windows

Rerunning luicode's Windows installer with Muse Code selected installs or updates luicode's managed Muse executable. To install or update only Muse Code:

& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Luigibarte4563/luicode/main/scripts/install-muse.ps1")))

To remove the Muse Code copy installed by LUICODE, keeping its data:

& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Luigibarte4563/luicode/main/scripts/uninstall-muse.ps1")))

luicode's ordinary uninstaller below continues to leave Muse Code installed.

Uninstall

Stop every running luicode command before uninstalling.

Removes

• luicode, including its desktop launcher and commands
• ~/.luicode/

Keeps

• uv and Python
• Your coding agents and RTK

macOS/Linux:

curl -fsSL "https://raw.githubusercontent.com/Luigibarte4563/luicode/main/scripts/uninstall.sh" | sh

Windows PowerShell:

& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Luigibarte4563/luicode/main/scripts/uninstall.ps1")))

Project Links

• Report bugs or request features
• Contributing guide
• Product E2E smoke tests
• Android/Termux guide

License

MIT License. See LICENSE for details. luicode is an independent continuation of the Free Claude Code project; the original author retains the copyright as recorded in the MIT license notice.