@solar_orb/agent_orb
v0.1.18
Published
Agent Orb local bootstrapper
Readme
agent_orb npx bootstrapper
Local development bootstrapper for Agent Orb. It is intended to become:
npx @solar_orb/agent_orbafter the package is published to npm.
Local development
From the repo root:
./scripts/release/smoke-npx-local.shFor manual testing:
npm --prefix packages/agent_orb run package-runtime
npx --yes ./packages/agent_orb setup --yesIf packages/agent_orb/releases contains a matching native bundle, setup installs that bundle directly with SHA256 verification. Otherwise it falls back to source build. On Windows, setup also adds the runtime bin directory to the user PATH so a new terminal can run agent_orb-codex, agent_orb-claude, agent_orb, codex-orb, and claude-orb directly. The adapter launchers call agent_orb launch, which starts the orb UI and daemon only for that CLI session. When the adapter CLI exits, the session-local agent_orbd and agent-orb-ui processes are stopped so the desktop orb does not linger.
Upgrade or repair an existing install:
npx @solar_orb/agent_orb upgrade --yesThe upgrade flow verifies the new bundle before stopping the old daemon/orb UI and removing old runtime files.
If Windows cannot auto-detect Codex CLI, set an explicit path before setup:
$env:AGENT_ORB_CODEX_PATH = "C:\nvm4w\nodejs\codex.cmd"
npx --yes @solar_orb/[email protected] upgrade --yesWindows local path
cd C:\path\to\AgentOrb
npx --yes .\packages\agent_orbIf no Windows bundle is present and Rust is not installed on Windows yet, setup will print:
winget install --id Rustlang.Rustup -eFor the intended no-Rust Windows path, publish or place agent-orb-windows-x64.zip plus checksums.txt in the release endpoint/package releases directory.
Windows + WSL repo caveat
Windows npm may fail with ERR_INVALID_URL when installing a local package directly from a UNC path like:
\\wsl.localhost\Ubuntu\home\...\AgentOrbFor Windows-host testing, prefer either:
- run from a Windows-local clone, or
- use a packed tarball from a Windows-local directory:
cd $env:TEMP\agent-orb-npx
npx --yes .\solar_orb-agent_orb-0.1.18.tgz --help