ADS FOR THE
AGENT ERA.

Start with Node.js.

Install Node.js 22.14 or newer ↗. npm comes with it. If you just installed Node, open a new terminal before running the commands below.

Windows: winget install OpenJS.NodeJS.LTS · macOS with Homebrew: brew install node · Linux: use the installer for your distribution from the Node.js page. Then check both versions below.

If npm install -g fails with EACCES on macOS or Linux, your Node.js was installed for the whole system. Install it with Homebrew or nvm instead of using sudo.

Run these in order.

Copy the whole block. The Claude Code version below is the one this Mikasa pilot currently supports.

# Check Node.js (22.14+) and npm; install Node first if either command is missing
node --version
npm --version

# Install the Mikasa-certified Claude Code version
npm install -g @anthropic-ai/claude-code@2.1.283

# Allow this Mikasa-hosted tarball for this command only; no permanent npm setting
npm install -g --allow-remote=all https://mikasa.space/downloads/mikasa-claude-0.3.16.tgz

# Sign in to Mikasa with Google or email; setup continues automatically
mikasa setup claude

# Start Claude Code; connect a model provider on first use
claude

Already installed Mikasa?

Mikasa 0.3.16 and later update themselves in the background when no ad is showing. On 0.3.12 to 0.3.15, run mikasa update once and it will update itself from then on. On anything older, including the earlier Adgent builds, run the two commands below. Setup cleans up what older versions left behind and keeps your account link, so there is no need to uninstall first.

# Install the latest Mikasa over the old one
npm install -g --allow-remote=all https://mikasa.space/downloads/mikasa-claude-0.3.16.tgz

# Refresh the Claude Code integration and remove old leftovers
mikasa setup claude

Prefer to update by hand? Run mikasa auto-update off. Leaving the pilot? mikasa uninstall removes everything, including leftovers from older versions. If it says the local service is still running, close Claude Code and run it again.

Everything the mikasa command does.

Run these in any terminal. Latest release: 0.3.16.

mikasa setup claude

Sign in with Google or email, link this computer, and install the Claude Code integration. Run it again to repair a broken setup.

mikasa update

Install the latest release now: download it, check it against the published checksum, install it, and refresh the Claude Code integration. Restart Claude Code afterwards.

mikasa update --check

Only report whether a newer release exists.

mikasa auto-update on|off

Mikasa checks for a new release every hour and installs it in the background when no ad is showing. On by default; turn it off to update only with mikasa update.

mikasa status

Show whether ads are enabled or paused on this computer.

mikasa pause

Stop showing ads until you resume. Claude Code keeps working normally.

mikasa resume

Start showing ads again after pause or disable.

mikasa disable

Turn ads off until you run mikasa resume.

mikasa uninstall

Remove the Claude Code integration, local data, and the npm package, including leftovers from older versions. Close Claude Code first.

mikasa version

Print the installed version.

mikasa help

List these commands in the terminal.