npm package · interactive guide

@erosolarcoder/erosolar-coder
install & usage.

Everything you need to install the package from npm and actually use the erosolar CLI day-to-day — verify Node, run npm i -g @erosolarcoder/erosolar-coder, launch it, and learn the most useful commands. Each step has a simulated terminal and copyable commands.

1 · Verify your Node.js install

Erosolar Coder ships as a native npm package and needs Node.js 18 or newer. Pick your platform — if node --version already prints v18+, jump straight to step 2.

Install Node via Homebrew, then verify:

$ brew install node

$ node --version && npm --version

Use your distro's package manager or nvm:

$ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

$ nvm install 22 && node --version

Install Node via winget in PowerShell, then verify:

> winget install OpenJS.NodeJS.LTS

> node --version; npm --version

~ — zsh — verify node

2 · Install @erosolarcoder/erosolar-coder

Install globally with -g so the erosolar binary is on your $PATH from any directory.

$ npm i -g @erosolarcoder/erosolar-coder

On Linux/macOS without admin rights, prefix with sudo or use a Node version manager like nvm.

~ — zsh — npm install

No global install?

Run with npx instead — no install, always latest:
npx @erosolarcoder/erosolar-coder

Project-local

Drop the -g to add it as a dev dependency, then call it via npm exec erosolar.

Upgrades

Re-run the same command any time — npm pulls the latest version straight from the registry.

3 · Run `erosolar`

From any folder in your terminal, type erosolar and hit return. The agent boots into your current working directory — point it at a repo to start coding with it.

$ cd ~/your-project && erosolar

~/your-project — erosolar

First-run sign-in

Erosolar opens your browser to authenticate, then caches the credential locally. Subsequent runs are instant.

Pick a model

Use /model inside the CLI to switch between DeepSeek, Claude, and other connected backends.

Human-in-the-loop

The agent asks before running shell commands or editing files. Approve, edit, or reject each step.

4 · Use the `erosolar` CLI

Once it's running, the CLI is mostly a chat prompt — type what you want, and it plans, reads, edits, and runs commands with your approval. These are the commands and flags you'll reach for most.

Slash commands inside the CLI

› /help

› /model deepseek-v4-pro

› /secrets

› /auto

› /stats

› /clear

› /exit

Sign-in is automatic on first launch — the CLI opens your browser to ero.solar/login and waits for the handoff. There's no /login slash command; rerun erosolar to re-trigger sign-in if your session has expired.

Useful shell invocations

$ erosolar --help

$ erosolar "explain the auth module and suggest tests"

$ npm update -g @erosolarcoder/erosolar-coder

$ npm uninstall -g @erosolarcoder/erosolar-coder

~/your-project — erosolar (live session)

Pre-fill the first prompt

Pass a positional prompt on the command line and the interactive shell launches with it queued as your first message — keep iterating from there.

Approval gates

Every shell command and file edit pauses for your approval — accept, edit, or reject inline. Interactive-only by design; there is no piped / headless mode that bypasses these gates.

Persistent memory

Switch backends

DeepSeek by default; /model swaps to Claude or any connected provider mid-session.

Read the full docs →

Prefer the registry? View the package on npmjs.com.