Back to agents

Install ShipAI CLI

Get the command-line tool to install and manage AI coding agents directly in your projects

Node.js 16+

Quick Install

npm install -g shipai-cli

After Installation

Verify installation
Browse available agents
Install your first agent

Test Commands

shipai --versionshipai listshipai install safety-guardian

Global Install

Install for all users on your system

npm install -g shipai-cli

Local Install

Install for a specific project

npm install shipai-cli

Using pnpm

Alternative package manager

pnpm add -g shipai-cli

Prerequisites

Required

  • Node.js 16.0 or higher
  • npm 6.0+ or pnpm 7.0+
  • Git (for some features)

Supported Platforms

  • macOS (Intel & Apple Silicon)
  • Linux (Ubuntu, Debian, CentOS)
  • Windows 10/11 (WSL recommended)

First Steps

1

Browse Available Agents

shipai list

See all available AI agents with descriptions and categories

2

Install Your First Agent

shipai install safety-guardian

Install a safety agent to protect your project from destructive commands

3

Check Installation Status

shipai status

See which agents are installed and their configuration

Troubleshooting

Permission Denied

If you get a permission error, try using sudo or fix npm permissions:

sudo npm install -g shipai-cli

Node.js Version

Check your Node.js version. ShipAI CLI requires Node.js 16 or higher:

node --version

Command Not Found

If the command isn't found, check your npm global path:

npm config get prefix