CLI reference

First run

prokop init

Prepare the data directory, run database migrations by default, install bundled preconfigs, start the daemon, and open the client.

prokop init [options]

Flag	Purpose
--db-path <path>	Use a custom database path
--tools-path <path>	Use a custom external tools directory
--run-migrations	Run schema migrations, the default behavior
--no-migrations	Skip schema migrations
--install-preconfigs	Install bundled preconfigs, the default behavior
--no-preconfigs	Skip bundled preconfigs
--force, -f	Force reinitialization

Daemon lifecycle

prokop start

Start Prokop as a background daemon.

prokop start [-p|--port <port>] [-h|--host <host>]

The default bind address is 0.0.0.0:8742.

prokop stop

Stop the background daemon.

prokop stop

prokop restart

Restart the daemon. It accepts the same host and port flags as start.

prokop restart [-p|--port <port>] [-h|--host <host>]

prokop status

Show whether the daemon is running, plus its PID, host, port, and start time.

prokop status

prokop logs

Follow the daemon log. Its default path is ~/.prokopai/server.log.

prokop logs

prokop server

Run the server in the foreground. Use this for service managers or direct debugging.

prokop server [-p|--port <port>] [-h|--host <host>]

Client and authentication

prokop open

Open the built-in client in your default browser.

prokop open

prokop auth

Show whether token authentication is enabled and print only a masked preview of the token.

prokop auth

Models

prokop models sync

Merge new providers and models from the upstream registry while keeping local additions.

prokop models sync

Use --override to replace the local models.json instead:

prokop models sync --override

Database maintenance

prokop migrate

Run pending SQLite schema migrations.

prokop migrate

prokop db stats

Show the database size and how much space can be reclaimed.

prokop db stats

prokop db cleanup

Delete orphaned rows without running SQLite VACUUM.

prokop db cleanup

prokop db vacuum

Delete orphaned rows, checkpoint the write-ahead log, and run SQLite VACUUM to reclaim disk space. Run this during a low-activity period because it requires exclusive database access.

prokop db vacuum

prokop migrate-legacy-data

Move legacy ~/.jean2 data to ~/.prokopai, including nested agent homes and stored workspace paths. Stop every Prokop or Jean2 server first.

prokop stop
prokop migrate-legacy-data

Updates

prokop update

Download and install a Prokop binary release.

prokop update [options]

Flag	Purpose
--version <version>	Install a specific version instead of latest
--force	Reinstall when that version is already present
--dry-run	Check for an update without changing the binary
--no-restart	Do not restart a running daemon after updating

Utility

Command	Purpose
prokop version	Print the installed version
prokop help	Print commands, options, and examples
prokop <command> --help	Show help for commands that expose subcommand help

Default files used by the CLI

These paths move with PROKOPAI_DATA_DIR when it is set.

File	Purpose
~/.prokopai/config.json	Initialization record and stored database and tools paths
~/.prokopai/models.json	Provider and model registry
~/.prokopai/.env	Credentials and server settings
~/.prokopai/server.pid	Daemon process record
~/.prokopai/server.log	Daemon logs

See Configuration for environment variables and server settings.