@kmugalkhod/lightcode 0.4.0 → 0.6.0
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 +20 -1
- package/cli.js +1575 -935
- package/lightcode.cjs +63 -18
- package/package.json +2 -1
- package/server.js +695 -238
package/README.md
CHANGED
|
@@ -6,6 +6,19 @@ permission-gated tool suite (files, shell, git, web, MCP), and tiered context
|
|
|
6
6
|
optimization that keeps long sessions inside the model's context window
|
|
7
7
|
without ever losing history.
|
|
8
8
|
|
|
9
|
+
## Install
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
npm install -g @kmugalkhod/lightcode
|
|
13
|
+
lightcode
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
Works on macOS (Apple Silicon and Intel), Linux, and Windows. Bun ships with
|
|
17
|
+
the package, so there's nothing else to install — the first `lightcode` run
|
|
18
|
+
uses the bundled runtime automatically (and reuses a system Bun if you already
|
|
19
|
+
have one). The published package is scoped as `@kmugalkhod/lightcode`; the
|
|
20
|
+
command it installs is `lightcode`.
|
|
21
|
+
|
|
9
22
|
## Quick start (from source)
|
|
10
23
|
|
|
11
24
|
```bash
|
|
@@ -13,6 +26,11 @@ bun install
|
|
|
13
26
|
bun run cli:dev # starts the TUI; it boots the server automatically
|
|
14
27
|
```
|
|
15
28
|
|
|
29
|
+
Lightcode is aware of the directory you launch it in: each turn it reads the
|
|
30
|
+
project's shape (top-level files, git branch/status) and any `AGENTS.md` /
|
|
31
|
+
`CLAUDE.md` / `README.md`, so "review my code" or "explain this" inspects your
|
|
32
|
+
actual files instead of asking you to paste them.
|
|
33
|
+
|
|
16
34
|
On first run Lightcode walks you through provider setup (Anthropic,
|
|
17
35
|
OpenRouter, OpenCode Zen, or any OpenAI-compatible endpoint) and stores the
|
|
18
36
|
API key in `~/.lightcode/credentials.json`. Environment variables such as
|
|
@@ -44,7 +62,8 @@ variables. Notable keys:
|
|
|
44
62
|
| `context.pruneAtFraction` | Tool-output pruning threshold (default 0.6) |
|
|
45
63
|
| `context.contextWindowOverride` | Override the model context window |
|
|
46
64
|
| `maxRetries` | Provider-call retries for transient errors (default 5) |
|
|
47
|
-
| `autoContinue.stallTimeoutSeconds` | Abort+retry a byte-silent stream (default
|
|
65
|
+
| `autoContinue.stallTimeoutSeconds` | Abort+retry a byte-silent stream (default 300; raise for very slow reasoning models) |
|
|
66
|
+
| `autoContinue.maxErrorRetries` | Auto-resends before surfacing a stream error (default 8) |
|
|
48
67
|
|
|
49
68
|
The local companion server listens on `127.0.0.1:4983` (uncommon on purpose —
|
|
50
69
|
port 3000 belongs to the apps you build). Override with `PORT` for the server
|