The 2501 CLI is a Node.js-based command-line tool that brings autonomous AI agents directly to your terminal. Installation takes just a few minutes.

​
System Requirements

  • Node.js: Version 16.x or higher
  • npm: Included with Node.js
  • Operating System: macOS, Linux, or Windows
Verify your Node.js installation: 
node --version
If Node.js isn’t installed, download it from nodejs.org.

​
Installation

Install the 2501 CLI globally to access it from anywhere: 
npm install -g @2501-ai/cli
This makes the @2501 command available system-wide.

​
Verify Installation

Confirm the CLI is installed: 
@2501 --version
You should see the installed version number.

​
Next Steps

After installation, authenticate the CLI with your 2501 account:
  1. Get your API key from accounts.2501.ai
  2. Follow the Authentication guide
  3. Start using the CLI with the Commands reference

​
Updating

Update to the latest version: 
npm update -g @2501-ai/cli
Check for available updates: 
npm outdated -g @2501-ai/cli

​
Troubleshooting

Permission Errors on macOS/Linux If you encounter permission errors, you may need sudo: 
sudo npm install -g @2501-ai/cli
Alternatively, configure npm to install global packages without sudo by following npm’s documentation. Command Not Found If the @2501 command isn’t recognized after installation, verify the installation completed successfully. Check that npm’s global bin directory is in your PATH, restart your terminal, and try reinstalling if needed. Windows Installation Issues On Windows, you may need to run your terminal as Administrator, use PowerShell or Command Prompt instead of Git Bash, or ensure npm is properly configured for global installations. For additional support, visit our Discord community or contact hello@2501.ai.