Files

Release Binaries / release (push) Has been cancelled

Details

v0.5.0: NomadArch - Binary-Free Mode Release

Features:
- Binary-Free Mode: No OpenCode binary required
- NomadArch Native mode with free Zen models
- Native session management
- Provider routing (Zen, Qwen, Z.AI)
- Fixed MCP connection with explicit connectAll()
- Updated installers and launchers for all platforms
- UI binary selector with Native option

Free Models Available:
- GPT-5 Nano (400K context)
- Grok Code Fast 1 (256K context)
- GLM-4.7 (205K context)
- Doubao Seed Code (256K context)
- Big Pickle (200K context)

2025-12-26 11:27:03 +04:00

2.7 KiB

Raw Blame History

CodeNomad Server

CodeNomad Server is the high-performance engine behind the CodeNomad cockpit. It transforms your machine into a robust development host, managing the lifecycle of multiple OpenCode instances and providing the low-latency data streams that long-haul builders demand. It bridges your local filesystem with the UI, ensuring that whether you are on localhost or a remote tunnel, you have the speed, clarity, and control of a native workspace.

Features & Capabilities

🌍 Deployment Freedom

Remote Access: Host CodeNomad on a powerful workstation and access it from your lightweight laptop.
Code Anywhere: Tunnel in via VPN or SSH to code securely from coffee shops or while traveling.
Multi-Device: The responsive web client works on tablets and iPads, turning any screen into a dev terminal.
Always-On: Run as a background service so your sessions are always ready when you connect.

⚡️ Workspace Power

Multi-Instance: Juggle multiple OpenCode sessions side-by-side with per-instance tabs.
Long-Context Native: Scroll through massive transcripts without hitches.
Deep Task Awareness: Monitor background tasks and child sessions without losing your flow.
Command Palette: A single, global palette to jump tabs, launch tools, and fire shortcuts.

Prerequisites

OpenCode: opencode must be installed and configured on your system.
Node.js 18+ and npm (for running or building from source).
A workspace folder on disk you want to serve.
Optional: a Chromium-based browser if you want --launch to open the UI automatically.

Usage

Run via npx (Recommended)

You can run CodeNomad directly without installing it:

npx @neuralnomads/codenomad --launch

Install Globally

Or install it globally to use the codenomad command:

npm install -g @neuralnomads/codenomad
codenomad --launch

Common Flags

You can configure the server using flags or environment variables:

Flag	Env Variable	Description
`--port <number>`	`CLI_PORT`	HTTP port (default 9898)
`--host <addr>`	`CLI_HOST`	Interface to bind (default 127.0.0.1)
`--workspace-root <path>`	`CLI_WORKSPACE_ROOT`	Default root for new workspaces
`--unrestricted-root`	`CLI_UNRESTRICTED_ROOT`	Allow full-filesystem browsing
`--config <path>`	`CLI_CONFIG`	Config file location
`--launch`	`CLI_LAUNCH`	Open the UI in a Chromium-based browser
`--log-level <level>`	`CLI_LOG_LEVEL`	Logging level (trace, debug, info, warn, error)

Data Storage

Config: ~/.config/codenomad/config.json
Instance Data: ~/.config/codenomad/instances (chat history, etc.)

2.7 KiB Raw Blame History Unescape Escape