vrr/CodeNomad
2
0
Fork 0
mirror of https://github.com/NeuralNomadsAI/CodeNomad.git synced 2026-07-10 00:14:27 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1
mirror of https://github.com/NeuralNomadsAI/CodeNomad link from https://www.reddit.com/r/opencodeCLI/comments/1txd7ua/comment/opvreck/
206 commits 32 branches 172 tags 111 MiB
Find a file
Alexis Purslane df625e0fe7
remove some duplication in README 
Refined descriptions for clarity and conciseness in the README.
2025-11-15 04:05:12 -05:00
.github/workflows filter release assets by extension 2025-11-14 14:03:44 +00:00
.opencode/agent Add web_developer 2025-10-28 18:47:30 +00:00
dev-docs Puff-up README 2025-11-14 23:26:13 +00:00
docs/screenshots Puff-up README 2025-11-14 23:26:13 +00:00
electron Change folder to codenomad for config 2025-11-14 14:25:04 +00:00
images chore: rebrand client and add icon tooling 2025-11-13 22:58:57 +00:00
scripts Don't try to publish and increment version number 2025-11-14 23:42:03 +00:00
src scope custom commands 2025-11-14 23:11:52 +00:00
tasks chore: rebrand client and add icon tooling 2025-11-13 22:58:57 +00:00
.gitignore Working messages display 2025-10-22 22:10:51 +01:00
BUILD.md chore: rebrand client and add icon tooling 2025-11-13 22:58:57 +00:00
electron.vite.config.ts Working messages display 2025-10-22 22:10:51 +01:00
logcat_output.txt Align prompt persistence and Electron builds with Node toolchain 2025-10-31 16:01:29 +00:00
package-lock.json chore: rebrand client and add icon tooling 2025-11-13 22:58:57 +00:00
package.json Don't try to publish and increment version number 2025-11-14 23:42:03 +00:00
postcss.config.js Working messages display 2025-10-22 22:10:51 +01:00
PROGRESS.md chore: rebrand client and add icon tooling 2025-11-13 22:58:57 +00:00
README.md remove some duplication in README 2025-11-15 04:05:12 -05:00
tailwind.config.js feat: define typography tokens 2025-10-28 18:55:48 +00:00
TOOL_CALL_IMPLEMENTATION.md chore: rebrand client and add icon tooling 2025-11-13 22:58:57 +00:00
tsconfig.json Working messages display 2025-10-22 22:10:51 +01:00
tsconfig.node.json Working messages display 2025-10-22 22:10:51 +01:00

README.md

CodeNomad

A fast, multi-instance desktop client for running OpenCode sessions the way long-haul builders actually work.

What is CodeNomad?

CodeNomad is built for people who live inside OpenCode for hours on end and need a cockpit, not a kiosk. When terminals get unwieldy and web clients feel laggy, CodeNomad delivers a desktop-native workspace that favors speed, clarity, and direct control. It runs on macOS, Windows, and Linux using Electron + SolidJS, with prebuilt binaries so you can get started immediately.

Multi-instance workspace

Command palette overlay

Highlights

  • Long-session native – scroll through massive transcripts without hitches and keep full context visible.
  • Multiple instances, one window – juggle several OpenCode instances side-by-side with per-instance tabs.
  • Deep task awareness – jump into sub/child sessions (Tasks tool) instantly, monitor their status, and answer directly without losing your flow.
  • Keyboard first – the full UI is optimized for shortcuts so you can stay mouse-free when you want to.
  • Command palette superpowers – summon a single, global palette to jump tabs, launch tools, tweak preferences, or fire shortcuts. Every action is categorized, fuzzy searchable, and previewed so you can chain moves together in seconds. It keeps your workflow predictable and fast whether you are juggling one session or ten.
  • Developer-friendly rendering – syntax highlighting, inline diffs, and thoughtful presentation keep the signal high.

Requirements

  • OpenCode CLI installed and available in your PATH, or point CodeNomad to a local binary through Advanced Settings.

Downloads

Grab the latest build for macOS, Windows, and Linux from the GitHub Releases page.

Quick Start

  1. Install the OpenCode CLI and confirm it is reachable via your terminal.
  2. Download the CodeNomad build for your platform and launch the app.
  3. Connect to one or more OpenCode instances, set keyboard shortcuts in preferences, and start a session.
  4. Use tabs to swap between instances, the task sidebar to dive into child sessions, and the prompt input to keep shipping.