CLI reference

Pull the image and start the container. Idempotent — runs cleanly on a clean machine or one that already has Genosyn.

Self-upgrade the CLI script, pull the latest image, and recreate the container. Pass --no-self-upgrade to skip the script update.

Update only the genosyn CLI script in place. Useful when the container is fine but you want a newer CLI.

Start a stopped container.

Stop the running container.

Stop, then start.

Show container state, image, volume, mapped port, and the URL to open.

Show container logs. -f follows. --tail caps how many lines to print.

Tarball the data volume. Defaults to a timestamped file in the current directory.

Restore a backup tarball. Destructive — prompts before overwriting unless -y is set.

Remove the container. --purge also deletes the data volume. Without --purge, data survives for the next install.

Remove orphaned Genosyn images left over from prior upgrades. --dry-run lists what would be removed.

Stand up a self-hosted, OpenAI-compatible vLLM server on a GPU host, then print the Base URL / Model id / API key to paste into Genosyn's Custom provider. Writes a compose file + .env to ~/.genosyn/vllm and drives docker compose. Idempotent — re-run to change the model or add a key. Requires an NVIDIA GPU + nvidia-container-toolkit + Docker Compose on the host.

Show the vLLM container state, whether the API is answering, and the connect URL. (Alias: genosyn vllm ps.)

Show vLLM server logs — useful for watching the first model download and load. -f follows.

Stop the vLLM server. Downloaded weights are kept by default; --purge also deletes the model cache volume.

List all users — email, name, handle, company count, signup date. Reads the app database inside the container (SQLite or Postgres). Pass --json for machine-readable output. (Alias: genosyn users.)

Reset a user's password — the operator escape hatch when someone is locked out and email isn't configured. Generates a strong password and prints it, or set your own with --password (min 8 chars). Prompts before overwriting unless -y. (Alias: genosyn reset-password.)

Delete a user. Removes their account and company memberships; content they authored (chat, todos, notes) is preserved but unlinked. Refuses if the user is the owner of a company — transfer ownership or delete that company first. Prompts before deleting unless -y.

Print CLI and container image versions.

Show usage.