@neuralnomads/codenomad 0.1.0 → 0.2.0-dev
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
ADDED
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
# CodeNomad Server
|
|
2
|
+
|
|
3
|
+
**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.
|
|
4
|
+
|
|
5
|
+
## Features & Capabilities
|
|
6
|
+
|
|
7
|
+
### 🌍 Deployment Freedom
|
|
8
|
+
- **Remote Access**: Host CodeNomad on a powerful workstation and access it from your lightweight laptop.
|
|
9
|
+
- **Code Anywhere**: Tunnel in via VPN or SSH to code securely from coffee shops or while traveling.
|
|
10
|
+
- **Multi-Device**: The responsive web client works on tablets and iPads, turning any screen into a dev terminal.
|
|
11
|
+
- **Always-On**: Run as a background service so your sessions are always ready when you connect.
|
|
12
|
+
|
|
13
|
+
### ⚡️ Workspace Power
|
|
14
|
+
- **Multi-Instance**: Juggle multiple OpenCode sessions side-by-side with per-instance tabs.
|
|
15
|
+
- **Long-Context Native**: Scroll through massive transcripts without hitches.
|
|
16
|
+
- **Deep Task Awareness**: Monitor background tasks and child sessions without losing your flow.
|
|
17
|
+
- **Command Palette**: A single, global palette to jump tabs, launch tools, and fire shortcuts.
|
|
18
|
+
|
|
19
|
+
## Prerequisites
|
|
20
|
+
- **OpenCode**: `opencode` must be installed and configured on your system.
|
|
21
|
+
- Node.js 18+ and npm (for running or building from source).
|
|
22
|
+
- A workspace folder on disk you want to serve.
|
|
23
|
+
- Optional: a Chromium-based browser if you want `--launch` to open the UI automatically.
|
|
24
|
+
|
|
25
|
+
## Usage
|
|
26
|
+
|
|
27
|
+
### Run via npx (Recommended)
|
|
28
|
+
You can run CodeNomad directly without installing it:
|
|
29
|
+
|
|
30
|
+
```sh
|
|
31
|
+
npx @neuralnomads/codenomad --launch
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
### Install Globally
|
|
35
|
+
Or install it globally to use the `codenomad` command:
|
|
36
|
+
|
|
37
|
+
```sh
|
|
38
|
+
npm install -g @neuralnomads/codenomad
|
|
39
|
+
codenomad --launch
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
### Common Flags
|
|
43
|
+
You can configure the server using flags or environment variables:
|
|
44
|
+
|
|
45
|
+
| Flag | Env Variable | Description |
|
|
46
|
+
|------|--------------|-------------|
|
|
47
|
+
| `--port <number>` | `CLI_PORT` | HTTP port (default 9898) |
|
|
48
|
+
| `--host <addr>` | `CLI_HOST` | Interface to bind (default 127.0.0.1) |
|
|
49
|
+
| `--workspace-root <path>` | `CLI_WORKSPACE_ROOT` | Default root for new workspaces |
|
|
50
|
+
| `--unrestricted-root` | `CLI_UNRESTRICTED_ROOT` | Allow full-filesystem browsing |
|
|
51
|
+
| `--config <path>` | `CLI_CONFIG` | Config file location |
|
|
52
|
+
| `--launch` | `CLI_LAUNCH` | Open the UI in a Chromium-based browser |
|
|
53
|
+
| `--log-level <level>` | `CLI_LOG_LEVEL` | Logging level (trace, debug, info, warn, error) |
|
|
54
|
+
|
|
55
|
+
### Data Storage
|
|
56
|
+
- **Config**: `~/.config/codenomad/config.json`
|
|
57
|
+
- **Instance Data**: `~/.config/codenomad/instances` (chat history, etc.)
|
|
58
|
+
|
package/dist/index.js
CHANGED
|
File without changes
|
package/package.json
CHANGED
|
@@ -1,11 +1,15 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@neuralnomads/codenomad",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0-dev",
|
|
4
4
|
"description": "CodeNomad Server",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Neural Nomads",
|
|
7
7
|
"email": "codenomad@neuralnomads.ai"
|
|
8
8
|
},
|
|
9
|
+
"repository": {
|
|
10
|
+
"type": "git",
|
|
11
|
+
"url": "https://github.com/NeuralNomadsAI/CodeNomad.git"
|
|
12
|
+
},
|
|
9
13
|
"type": "module",
|
|
10
14
|
"main": "dist/index.js",
|
|
11
15
|
"bin": {
|