CLI Reference

The jean2 command-line tool is a single binary that manages your server, tools, and authentication. Installed via the install script to ~/.jean2/bin.

Server Commands

jean2 init

First-time setup wizard. Creates the ~/.jean2/ config directory, installs default preconfigs, and installs recommended tools. Run this once after installation.

jean2 start

Start the server as a background daemon. The server listens on http://localhost:8742 by default (configurable via JEAN2_PORT).

jean2 start

jean2 stop

Stop the running server daemon.

jean2 stop

jean2 restart

Restart the server. Use this after changing configuration that requires a restart (like JEAN2_AUTH_TOKEN).

jean2 restart

jean2 update

Pull the latest version, replace the binary, and restart the server. Database migrations run automatically on startup.

jean2 update

Tool Commands

jean2 tools list

List available and installed tools.

jean2 tools list                # All tools (available + installed)
jean2 tools list --installed    # Only installed tools
jean2 tools list --json         # JSON output
jean2 tools list --extensions   # Show extension and env config details

jean2 tools install

Install tools from the registry.

jean2 tools install                  # Interactive selection
jean2 tools install --recommended    # Install recommended set
jean2 tools install --all            # Install all available tools
jean2 tools install glob grep shell  # Install specific tools

jean2 tools update

Update installed tools to their latest versions.

jean2 tools update              # Update all installed tools
jean2 tools update --dry-run    # Preview what would be updated

jean2 tools remove

Remove installed tools.

jean2 tools remove shell        # Remove a specific tool
jean2 tools remove --all        # Remove all installed tools

jean2 tools outdated

Check for available tool updates without installing them.

jean2 tools outdated

Environment Variables

Configure the server through ~/.jean2/.env or shell environment variables:

Variable	Default	Description
JEAN2_PORT	8742	Server listen port
JEAN2_AUTH_TOKEN	(unset)	When set, enables token-based authentication
JEAN2_TLS_ENABLED	false	Enable HTTPS/TLS
JEAN2_TLS_CERT_FILE	(unset)	Path to TLS certificate file
JEAN2_TLS_KEY_FILE	(unset)	Path to TLS private key file

Configuration Directory

All configuration lives in ~/.jean2/:

~/.jean2/
  .env               # Environment variables (API keys, port, auth)
  models.json        # Model definitions and defaults
  preconfigs/        # Agent personality presets
  prompts/           # Reusable prompt templates
  tools/             # Installed tools
  AGENTS.md          # Global instructions (every session)
  bin/               # Server binary
  data/
    agent.db         # SQLite database (sessions, messages, permissions)