@slenderbuilds/niti 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shubhadeep Datta
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,155 @@
+# niti
+
+**A terminal CLI that runs multiple AI coding agents — from different LLM providers — concurrently on one project.**
+
+Assign models to custom roles (Gemini = Frontend, Claude = Backend, GPT = Reviewer...), pick one as the **orchestrator** to plan the work into a task DAG, and watch the team build together, **talking to each other directly** to stay aligned — live in your terminal, or in an optional web dashboard.
+
+[![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](#license)
+[![Bun](https://img.shields.io/badge/core-Bun%20%2F%20TypeScript-f9f1e1)](#two-front-ends-one-core)
+[![Go](https://img.shields.io/badge/TUI-Go%20%2F%20Bubbletea-00add8)](#two-front-ends-one-core)
+
+<img src="readme_images/CLI.png" alt="niti's terminal UI — team of 4 agents, live context/token sidebar" width="100%">
+
+## Quickstart
+
+```sh
+npm install -g @slenderbuilds/niti   # prebuilt binaries — no Bun, no Go, no build step
+niti                                 # pick your team, then start building
+```
+
+> Published as **`@slenderbuilds/niti`** — the unscoped `niti` was rejected by npm's own
+> anti-squatting check (too similar to `jiti`/`vite`/others), and it suggested this scope. The
+> commands are still `niti` (TUI) and `niti-core` (headless engine); project state still lives
+> in `.niti/` — only the install name changed.
+
+On first launch, `niti` opens a picker: how many teammates (1–6), then per teammate — provider,
+model, name, and a one-line job description. **29 providers / 152 models** from the
+[Models.dev](https://models.dev) catalog, plus local (Ollama/LM Studio) and **Custom** for any
+OpenAI-compatible endpoint. Keys live in `~/.config/niti/auth.json` (0600) and your OS keychain —
+never a server.
+
+Type `/` for the full command list:
+
+<img src="readme_images/commands.png" alt="the / command palette, listing every slash command" width="100%">
+
+## Watch it from the browser too
+
+`/dashboard` opens a live control center — agent avatars, message graph, task board, and per-agent
+usage, all pushed over SSE as the team works:
+
+<img src="readme_images/dashboardniti.png" alt="the web dashboard — live agent graph with task/message/usage panels" width="100%">
+
+`/graph` opens an interactive force-graph — your project's file/import structure, or (toggle to
+**Models**) the live agent-to-agent conversation as it happens:
+
+<table>
+<tr>
+<td width="50%"><img src="readme_images/graph1.png" alt="project mode: 137-file dependency graph"></td>
+<td width="50%"><img src="readme_images/graph2.png" alt="models mode: live pixel-art agent avatars, message-colored edges"></td>
+</tr>
+<tr>
+<td>Project mode — every file, colored by directory</td>
+<td>Models mode — your team, colored by status, talking in real time</td>
+</tr>
+</table>
+
+Both pages retheme live with whatever theme (`ctrl+t` / `/theme`) the TUI has active.
+
+## Everything, at a glance
+
+`/settings` (or `tab`) opens Status, Config, Usage, and Stats panes without leaving the session:
+
+<table>
+<tr>
+<td width="33%"><img src="readme_images/status.png" alt="Status tab — version, team, mode, theme, models"></td>
+<td width="33%"><img src="readme_images/usage.png" alt="Usage tab — session cost, tokens, per-agent breakdown"></td>
+<td width="34%"><img src="readme_images/stats_models.png" alt="Stats tab — tokens per day, tokens by model"></td>
+</tr>
+</table>
+
+## What's actually happening under the hood
+
+- **Orchestrator DAG** — the lead agent turns your goal into a validated task graph (dependencies +
+  hand-offs), not a flat queue; independent tasks run concurrently and the lead reviews at the end.
+- **Agent-to-agent messaging** — any teammate can `ask_agent`/`send_message` another mid-task (e.g.
+  frontend asking backend about an API shape), rate-capped per pair as the loop guard.
+- **Sandboxed tools** — `read_file` / `write_file` / `edit` / `shell`, gated per-agent by
+  `allowedTools` and a wildcard permission policy; every path is jailed to the project root.
+- **Approval gates** — agents pause for `[y] approve · [n] deny · [a] always` before risky actions,
+  answered from the TUI or the web dashboard; dangerous shell patterns always prompt.
+- **Persistence** — every turn checkpoints to SQLite (`.niti/niti.db`); `niti-core resume` picks up
+  unfinished tasks with history intact. `/undo` and `/rewind` revert file writes.
+- **MCP + LSP** — declare `mcpServers`/`lsp` in `agents.yaml`; both merge into the same tool loop,
+  gated the same way as everything else.
+- **Failover** — a 429/overload/context-limit requeues the task instead of failing it; another agent
+  picks it up.
+
+See [`project_context.md`](./project_context.md) for the full architecture record, the verification
+history, and the deliberate ceilings (what's intentionally out of scope, and why).
+
+## Configuring agents
+
+`niti` rewrites only the `agents:` block on each team pick — everything else survives a relaunch.
+Edit `.niti/agents.yaml` directly for anything the picker doesn't cover:
+
+```yaml
+agents:
+  - id: architect
+    provider: anthropic
+    model: claude-opus-4-8
+    role: Architect
+    lead: true
+    systemPrompt: You are a software architect. Decompose work into independent subtasks.
+  - id: engineer
+    provider: openai
+    model: gpt-4o
+    role: Backend Engineer
+    systemPrompt: You are a backend engineer. Implement the assigned task.
+    allowedTools: [read_file, write_file, edit, shell, mcp]
+
+permissions:
+  shell: { "git *": allow, "git commit *": ask, "rm -rf*": deny }
+  write_file: { "src/**": allow, "*": ask }
+
+mcpServers:
+  - name: code-review
+    command: code-review-graph
+    args: [--stdio]
+
+theme: niti          # ctrl+t / /theme opens a live carousel, synced to any open dashboard/graph tab
+auto: false          # approve anything not explicitly denied
+maxAgents: 6
+```
+
+Full config reference — permissions resolution order, environment variables, LSP setup — lives in
+[`project_context.md`](./project_context.md).
+
+## From source
+
+Requires [Bun](https://bun.sh) ≥ 1.3 and [Go](https://go.dev) ≥ 1.22.
+
+```sh
+bun install
+bun run build:tui                 # builds ./niti (the Go TUI)
+./niti
+```
+
+Headless / scripting, no interactive terminal needed:
+
+```sh
+bun run src/cli.ts "Build a clothing website for gen-z."   # one-shot
+bun run src/cli.ts --web "..."                              # + live web dashboard
+bun run src/server/main.ts                                  # headless server, prints its own handshake URL
+```
+
+## Development
+
+```sh
+bun test                                                     # TypeScript unit + integration tests
+bunx tsc --noEmit                                             # typecheck
+cd tui && go build ./... && go vet ./... && go test ./...    # Go TUI: build, vet, unit tests
+```
+
+## License
+
+MIT.

package/bin/niti-core.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+// The headless engine/scripting CLI (`niti-core "task"`, `serve`, `auth`, …). Same handover as
+// bin/niti.js — the TUI spawns this binary directly as a sibling, without going through Node.
+import { spawnSync } from "node:child_process";
+import { binPath } from "./resolve.js";
+
+process.exit(spawnSync(binPath("niti-core"), process.argv.slice(2), { stdio: "inherit" }).status ?? 1);

package/bin/niti.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+// The interactive TUI. Node runs this shim; everything after the handover is Go and Bun.
+import { spawnSync } from "node:child_process";
+import { binPath } from "./resolve.js";
+
+process.exit(spawnSync(binPath("niti"), process.argv.slice(2), { stdio: "inherit" }).status ?? 1);

package/bin/resolve.js

@@ -0,0 +1,32 @@
+import { createRequire } from "node:module";
+
+const require = createRequire(import.meta.url);
+
+// This package ships no binaries. The real executables live in per-platform packages
+// (`niti-darwin-arm64`, …) declared as optionalDependencies with `os`/`cpu` set, so npm installs
+// exactly the one that matches and skips the other four.
+//
+// PLATFORM_BASE is deliberately NOT derived from this package's own `name`: the root wrapper is
+// published as a scoped package (`@slenderbuilds/niti`, npm's own suggestion — the unscoped `niti`
+// collided with its squatting-prevention check against jiti/vite/nib/…), but the five platform
+// packages are unscoped (`niti-darwin-arm64`, …) and were already published under that name before
+// the scope existed. `${name}-${platform}` would have produced `@slenderbuilds/niti-darwin-arm64`,
+// which is not a real package — see scripts/build-release.ts, which publishes under this same
+// hardcoded base.
+const PLATFORM_BASE = "niti";
+
+export function binPath(exe) {
+  const platformPkg = `${PLATFORM_BASE}-${process.platform}-${process.arch}`;
+  const ext = process.platform === "win32" ? ".exe" : "";
+  try {
+    return require.resolve(`${platformPkg}/bin/${exe}${ext}`);
+  } catch {
+    console.error(
+      `niti: no prebuilt binary for ${process.platform}-${process.arch} (looked for ${platformPkg}).\n` +
+        `Supported: darwin-arm64, darwin-x64, linux-x64, linux-arm64, win32-x64.\n` +
+        `If your platform is on that list, reinstall — npm sometimes skips optional dependencies ` +
+        `(https://github.com/npm/cli/issues/4828).`,
+    );
+    process.exit(1);
+  }
+}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@slenderbuilds/niti",
+  "version": "0.1.0",
+  "description": "A terminal CLI that runs multiple AI coding agents from different LLM providers concurrently on one project.",
+  "type": "module",
+  "bin": {
+    "niti": "bin/niti.js",
+    "niti-core": "bin/niti-core.js"
+  },
+  "files": [
+    "bin/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "bun run src/cli.ts",
+    "serve": "bun run src/server/main.ts",
+    "build": "bun build --compile ./src/cli.ts --outfile niti-core",
+    "build:tui": "cd tui && go mod tidy && go build -o ../niti ./cmd/niti",
+    "build:all": "bun run build:tui && bun run build",
+    "build:release": "bun run scripts/build-release.ts",
+    "test": "bun test src web",
+    "typecheck": "tsc --noEmit",
+    "gen:catalog": "bun run scripts/gen-catalog.ts"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/slenderongithub/niti.git"
+  },
+  "homepage": "https://github.com/slenderongithub/niti#readme",
+  "bugs": {
+    "url": "https://github.com/slenderongithub/niti/issues"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "cli",
+    "tui",
+    "llm",
+    "coding-agent",
+    "multi-agent",
+    "anthropic",
+    "openai",
+    "gemini"
+  ],
+  "author": "Shubhadeep Datta <slenderisincollege@gmail.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "optionalDependencies": {
+    "niti-darwin-arm64": "0.1.0",
+    "niti-darwin-x64": "0.1.0",
+    "niti-linux-arm64": "0.1.0",
+    "niti-linux-x64": "0.1.0",
+    "niti-win32-x64": "0.1.0"
+  },
+  "devDependencies": {
+    "@anthropic-ai/sdk": "^0.115.0",
+    "@google/genai": "^2.13.0",
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "@napi-rs/keyring": "^1.3.0",
+    "@types/bun": "^1.3.14",
+    "openai": "^7.0.0",
+    "typescript": "^7.0.2",
+    "yaml": "^2.9.0",
+    "zod": "^4.4.3"
+  }
+}