{"_id":"relavium","_rev":"2-b03dac9c690839daa65b809f878c8416","name":"relavium","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"relavium","version":"0.1.0","keywords":["relavium","ai","agent","workflow","cli","llm"],"license":"SEE LICENSE IN LICENSE","_id":"relavium@0.1.0","maintainers":[{"name":"hodetech","email":"hodetech@outlook.com"}],"homepage":"https://github.com/HodeTech/Relavium#readme","bugs":{"url":"https://github.com/HodeTech/Relavium/issues"},"bin":{"relavium":"dist/index.js"},"dist":{"shasum":"784d0b02345f3671a8fdfdc24218876945ee45de","tarball":"https://registry.npmjs.org/relavium/-/relavium-0.1.0.tgz","fileCount":15,"integrity":"sha512-JToPllrk+Fns6+YaYtcjXMJ5jgKGGHpMtmv4jnZvcI5S49dshioyEFWP2mfauKB8fdyOo4yzrXpiECGovfjXHQ==","signatures":[{"sig":"MEYCIQCxntxuNn+2Ysw8nxMPMOW7k7+M3Xqja8vkPQmNRYTJKwIhAKopU61cUl0A56KO8qjPYJWe1Cfmo6/w6qV8ccqCMEz0","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/relavium@0.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":517204},"type":"module","_from":"file:artifact/relavium-0.1.0.tgz","engines":{"node":">=20.12.0"},"scripts":{"lint":"eslint src","test":"vitest run","build":"tsup","typecheck":"tsc -p tsconfig.json --noEmit"},"_npmUser":{"name":"hodetech","email":"hodetech@outlook.com"},"_resolved":"/home/runner/work/Relavium/Relavium/artifact/relavium-0.1.0.tgz","_integrity":"sha512-JToPllrk+Fns6+YaYtcjXMJ5jgKGGHpMtmv4jnZvcI5S49dshioyEFWP2mfauKB8fdyOo4yzrXpiECGovfjXHQ==","repository":{"url":"git+https://github.com/HodeTech/Relavium.git","type":"git","directory":"apps/cli"},"_npmVersion":"10.9.8","description":"Relavium CLI (`relavium`) — run agent workflows from the terminal; the engine's first real consumer.","directories":{},"_nodeVersion":"22.23.0","dependencies":{"ink":"^6.8.0","zod":"^3.23.0","yaml":"^2.9.0","react":"^19.2.7","openai":"^6.42.0","commander":"^12.1.0","smol-toml":"^1.3.4","drizzle-orm":"^0.45.2","@google/genai":"^2.8.0","@clack/prompts":"^1.6.0","better-sqlite3":"^12.10.0","@napi-rs/keyring":"^1.3.0","@anthropic-ai/sdk":"^0.101.0","quickjs-emscripten-core":"^0.32.0","@jitl/quickjs-singlefile-mjs-release-sync":"^0.32.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","eslint":"^9.17.0","vitest":"^3.0.0","typescript":"^5.7.2","@types/node":"^20.12.0","@relavium/db":"0.0.0","@types/react":"^19.2.17","@relavium/llm":"0.0.0","@relavium/core":"0.0.0","@relavium/shared":"0.0.0"},"_npmOperationalInternal":{"tmp":"tmp/relavium_0.1.0_1782331303901_0.08483846781823257","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"relavium","version":"0.1.1","description":"The local-first Relavium CLI — run multi-model AI agent sessions and git-committable workflows from your terminal.","license":"SEE LICENSE IN LICENSE","type":"module","bin":{"relavium":"dist/index.js"},"keywords":["relavium","ai","agent","ai-agent","multi-agent","workflow","cli","llm","local-first","mcp","anthropic","openai","gemini","deepseek"],"repository":{"type":"git","url":"git+https://github.com/HodeTech/Relavium.git","directory":"apps/cli"},"engines":{"node":">=20.12.0"},"dependencies":{"@anthropic-ai/sdk":"^0.101.0","@clack/prompts":"^1.6.0","@google/genai":"^2.8.0","@jitl/quickjs-singlefile-mjs-release-sync":"^0.32.0","@modelcontextprotocol/sdk":"^1.29.0","@napi-rs/keyring":"^1.3.0","better-sqlite3":"^12.10.0","commander":"^12.1.0","drizzle-orm":"^0.45.2","ink":"^6.8.0","openai":"^6.42.0","quickjs-emscripten-core":"^0.32.0","react":"^19.2.7","smol-toml":"^1.3.4","yaml":"^2.9.0","zod":"^3.23.0"},"devDependencies":{"@types/node":"^20.12.0","@types/react":"^19.2.17","eslint":"^9.17.0","tsup":"^8.5.0","typescript":"^5.7.2","vitest":"^3.0.0","@relavium/core":"0.0.0","@relavium/llm":"0.0.0","@relavium/mcp":"0.0.0","@relavium/db":"0.0.0","@relavium/shared":"0.0.0"},"scripts":{"build":"tsup","typecheck":"tsc -p tsconfig.json --noEmit","lint":"eslint src","test":"vitest run"},"_id":"relavium@0.1.1","bugs":{"url":"https://github.com/HodeTech/Relavium/issues"},"homepage":"https://github.com/HodeTech/Relavium#readme","_integrity":"sha512-CP3VcQwy8VMcD00DLwbPVpA6TS0PWusQ5oq4VqX8cYLJcCKFzLLnrbL75EcXpqOQCGoFWp5FN2wPnjocHaaE8A==","_resolved":"/home/runner/work/Relavium/Relavium/artifact/relavium-0.1.1.tgz","_from":"file:artifact/relavium-0.1.1.tgz","_nodeVersion":"22.23.0","_npmVersion":"10.9.8","dist":{"integrity":"sha512-CP3VcQwy8VMcD00DLwbPVpA6TS0PWusQ5oq4VqX8cYLJcCKFzLLnrbL75EcXpqOQCGoFWp5FN2wPnjocHaaE8A==","shasum":"07f2c8700691a54bed916015e4fd770ae465062d","tarball":"https://registry.npmjs.org/relavium/-/relavium-0.1.1.tgz","fileCount":16,"unpackedSize":606704,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/relavium@0.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFydtAt4aGMCrgPB+MvZ9yKqqhYHLN8yrFzFWrRsiW2tAiEAkD7cBHI/maeyNLwh39XdPPZT0Q5ca+i4eFmJS6GlznI="}]},"_npmUser":{"name":"hodetech","email":"hodetech@outlook.com"},"directories":{},"maintainers":[{"name":"hodetech","email":"hodetech@outlook.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/relavium_0.1.1_1782636970025_0.5895962720016921"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-24T20:01:43.725Z","modified":"2026-06-28T08:56:10.453Z","0.1.0":"2026-06-24T20:01:44.099Z","0.1.1":"2026-06-28T08:56:10.173Z"},"bugs":{"url":"https://github.com/HodeTech/Relavium/issues"},"license":"SEE LICENSE IN LICENSE","homepage":"https://github.com/HodeTech/Relavium#readme","keywords":["relavium","ai","agent","ai-agent","multi-agent","workflow","cli","llm","local-first","mcp","anthropic","openai","gemini","deepseek"],"repository":{"type":"git","url":"git+https://github.com/HodeTech/Relavium.git","directory":"apps/cli"},"description":"The local-first Relavium CLI — run multi-model AI agent sessions and git-committable workflows from your terminal.","maintainers":[{"name":"hodetech","email":"hodetech@outlook.com"}],"readme":"# relavium\n\n![Node](https://img.shields.io/badge/node-%E2%89%A5%2020.12-339933?logo=nodedotjs&logoColor=white)\n![Local-first](https://img.shields.io/badge/local--first-BYOK-0aa)\n![License](https://img.shields.io/badge/license-proprietary-555)\n\n> **Start as an agent. Ship the workflow. Own every run.**\n\n`relavium` is the command-line surface of **[Relavium](https://github.com/HodeTech/Relavium)** — a\nlocal-first, multi-model AI agent platform from **[HodeTech](https://github.com/HodeTech)**. Begin in a\nconversational **agent session** in your terminal, graduate it into a git-committable, multi-agent\n`.relavium.yaml` **workflow**, and run it anywhere — all on the same pure-TypeScript engine that powers\nthe Relavium desktop and VS Code surfaces. Every step is debuggable, every token and dollar tracked, and\nnothing leaves your machine unless you choose it.\n\n## Install\n\n```bash\nnpm install -g relavium\n```\n\nRequires **Node.js ≥ 20.12**. The package is an engine-inlined bundle that installs prebuilt native\nbinaries — no C/C++ toolchain, no Python sidecar.\n\n## Quick start\n\n```bash\n# 1 · Point Relavium at a provider — your key goes to the OS keychain, never a file or argv\nrelavium provider add anthropic\necho \"$ANTHROPIC_API_KEY\" | relavium provider set-key anthropic\n\n# 2 · Start as an agent — a streaming, multi-turn session in your terminal\nrelavium chat\n#     …converse until a flow proves itself, then run /export inside the REPL\n#     to ship the session to a git-committable .relavium.yaml\n\n# 3 · Own every run — execute the workflow, streaming live (or --json for CI)\nrelavium run ./my-workflow.relavium.yaml --input file=./src/index.ts\nrelavium run ./my-workflow.relavium.yaml --json\n```\n\nPrefer authoring directly? `relavium create` scaffolds an agent or a minimal single-agent workflow from\nan interactive wizard.\n\n## Why relavium\n\n- **One engine, every surface.** The terminal, desktop, and VS Code run the _identical_ engine — a\n  workflow behaves the same on your laptop and in CI.\n- **A chat-to-workflow continuum.** Sessions are persistent and resumable; one command — `/export` —\n  turns a proven conversation into a reviewed, committed workflow.\n- **Multi-model with fallback chains.** Route across Anthropic, OpenAI / DeepSeek, and Gemini behind one\n  seam; a run survives a provider outage by failing over (`[claude → gpt-4o → gemini]`).\n- **Local-first, keys in your OS keychain.** BYOK, no account, no telemetry — keys never touch a file, a\n  log, an argv, or `--json` output.\n- **Live _and_ scriptable.** A rich streaming TUI on a TTY; a stable NDJSON `RunEvent` stream with\n  deterministic exit codes under `--json` for CI.\n- **Extensible and multimodal.** Agents consume external **MCP** tools (stdio + `http` / `sse` /\n  `websocket`, behind an SSRF floor), and workflows generate image / audio / video **output** through the\n  same engine (media input via `read_media` is a tracked follow-up).\n\n## Commands\n\n### Agent sessions\n\n| Command                                       | Purpose                                                     |\n| --------------------------------------------- | ----------------------------------------------------------- |\n| `relavium chat [--agent <ref>]`               | Start an interactive multi-turn agent session (the REPL).   |\n| `relavium chat-resume <sessionId>`            | Reload and continue a persisted session.                    |\n| `relavium chat-list`                          | List past sessions (id, agent, last activity).              |\n| `relavium chat-export <sessionId>`            | Export a session to a `.relavium.yaml` workflow scaffold.   |\n| `relavium agent run <agent> [--fixture <p>]`  | Run a single agent one-shot (prompt on **stdin**); `--fixture` replays a cassette (offline, CI-ready). |\n\n### Workflows & authoring\n\n| Command                              | Purpose                                                            |\n| ------------------------------------ | ----------------------------------------------------------------- |\n| `relavium run <workflow> [--input k=v]` | Execute a workflow — live TUI, or `--json` NDJSON for CI.       |\n| `relavium create`                    | Scaffold a new agent or a minimal workflow from a wizard.         |\n| `relavium import <path>`             | Import an external `.relavium.yaml` / `.agent.yaml` into the project. |\n| `relavium export <id>`               | Write a portable, share-safe copy (no secret material).           |\n\n### History & human gates\n\n| Command                                              | Purpose                                              |\n| ---------------------------------------------------- | ---------------------------------------------------- |\n| `relavium list [--agents]`                           | List discovered workflows (or agents) + last-run status. |\n| `relavium logs <runId>`                              | Replay a past run's event stream (raw under `--json`). |\n| `relavium status`                                    | Show active / paused runs and their per-node status. |\n| `relavium gate <runId> --approve\\|--reject\\|--input …` | Resolve a pending human gate.                       |\n| `relavium gate list [<runId>]`                       | List pending human gates across runs.                |\n\n### Providers & keys\n\n| Command                          | Purpose                                                     |\n| -------------------------------- | ---------------------------------------------------------- |\n| `relavium provider list`         | Registered providers and whether a key is set.             |\n| `relavium provider add <id>`     | Register a provider.                                        |\n| `relavium provider set-key <id>` | Store a key in the OS keychain (read from **stdin**).       |\n| `relavium provider remove-key <id>` | Delete a key from the keychain.                          |\n| `relavium provider test <id>`    | Verify a key with a minimal live request.                  |\n\nThe global flags `--json`, `--cwd`, `--config`, `--no-color`, `--verbose` (`-v`), and `--quiet` (`-q`)\napply throughout. Run `relavium --help` or `relavium <command> --help` for the full surface.\n\n## Exit codes\n\nDeterministic, for CI:\n\n| Code | Meaning                                                                |\n| ---- | --------------------------------------------------------------------- |\n| `0`  | Completed successfully                                                 |\n| `1`  | Workflow failed (a node errored and exhausted retries / fallbacks)     |\n| `2`  | Invalid invocation (bad arguments, not found, schema error)            |\n| `3`  | Run paused at a human gate (non-interactive) — resume with `relavium gate` |\n| `4`  | A `relavium chat` / `chat-resume` session ended (`/exit`, `/cancel`, or input EOF) |\n\nFor a workflow run or agent session, `--json` makes stdout a pure NDJSON stream — `RunEvent`s for `run` /\n`gate`, `SessionEvent`s for `chat` / `agent run` — with all diagnostics on stderr. (`--help`, `--version`,\nand a bare invocation stay human-readable on stdout.)\n\n## Keys & configuration\n\nProvider keys resolve **OS keychain → `RELAVIUM_<PROVIDER>_API_KEY` env var → error** — no plaintext\nfallback, and only a 4-character hint is ever displayed. Configuration layers from `~/.relavium/`\n(global) and a project `.relavium/`, with CLI flags and env vars overriding. Run history persists locally\nto `~/.relavium/history.db`.\n\n## Documentation\n\nThe full command reference, the `--json` machine-output contract, and the CI guide live in the Relavium\ndocs: **[docs/reference/cli/commands.md](https://github.com/HodeTech/Relavium/blob/main/docs/reference/cli/commands.md)**.\n\n## License\n\nProprietary — © HodeTech, all rights reserved. Not open source; no rights are granted except as expressly\nstated. See **[LICENSE](https://github.com/HodeTech/Relavium/blob/main/LICENSE)**.\n","readmeFilename":"README.md"}