Install

Prefer the skill for AI agents (auto binary + MCP + login). Curl/irm remain for a direct CLI install without an agent.

Agent skill (recommended)

Adds the onlinesim-mcp skill so the agent can install the binary, start MCP, and ask for an API key when needed:

Bash

npx skills add on-org/onlinesim-mcp
npx skills add on-org/onlinesim-mcp -g
npx skills add on-org/onlinesim-mcp -a cursor -y

New agent chat: the skill runs ensure-ready first (binary → MCP up → auth). If there is no key, the agent asks you to paste it and runs onlinesim login --apikey …

Always-on every chat: copy skills/onlinesim-mcp/rules/onlinesim-mcp.mdc into the project .cursor/rules/, or paste it into Cursor → Settings → Rules → User Rules.

Direct binary

Installs into ~/.local/bin by default (override with ONLINESIM_INSTALL_DIR). No agent required.

Bash

curl -fsSL https://raw.githubusercontent.com/on-org/onlinesim-mcp/master/install.sh | sh

Verify

Open a new terminal so PATH updates apply, then run:

Bash

onlinesim --version
onlinesim doctor

If the command is not found, ensure the install directory is on your PATH, or open a new shell.

Update

After install, upgrade the CLI by running the same installer again — it replaces the binary with the latest GitHub Release.

On startup, onlinesim may print a hint when a newer release exists (checked about once per day). Restart MCP after updating so clients use the new binary.

Bash

curl -fsSL https://raw.githubusercontent.com/on-org/onlinesim-mcp/master/install.sh | sh

If you installed the Agent Skill, refresh it separately:

Bash

npx skills update onlinesim-mcp
npx skills update -g

Disable the update hint with a flag or env:

Bash

# one command
onlinesim --no-update-check doctor

# or permanently
export ONLINESIM_NO_UPDATE=1