Command line¶

Run these from Starfarer's folder, with its own Python: .venv\Scripts\python on Windows, .venv/bin/python elsewhere (shown as python below).

Starbase¶

Command
`python -m starfarer`	start Starbase (`start.bat` / `start.sh` run this, and start it again after a restart or crash)
`python -m starfarer --open`	start it and open the Bridge in the browser
`python -m starfarer reset-password <username>`	a new password for someone locked out with no recovery codes left (on the Starbase PC only)
`python -m starfarer persona-models [--size standard\\|lite\\|ultralite] [--replace] [names…]`	build the built-in personas' models in Ollama (all four, in the chosen size, if no names are given); `--replace` makes installed ones again, keeping the old as `<name>-old-<date>`
`python -m starfarer.voice.fetch`	download the voice files (checked against their pinned hashes)

Command
`python -m starfarer spacedock keygen <key file>`	make a publisher key: keep the file private, outside any repository
`python -m starfarer spacedock pack <module folder> <catalog folder> …`	zip, sign and list a Module in a catalog
`python -m starfarer spacedock art <module folder> <catalog folder>`	update only how a Module looks in a catalog (icon, screenshots, about): no key
`python -m starfarer spacedock verify <catalog folder>`	check every Module in a catalog against its signature

See Writing Modules for the options.

Anyone who can write to the data folder can already change Starbase, so these are admin conveniences:

File in `data\`
`restart.request`	Starbase restarts within a few seconds (the file's text goes in the audit log as the reason)
`diag.request`	one sentence per line: how the AI would pick tools for each, written to `data\logs\tools-diag.txt`; a line `mission: <job>` is a dry run of an away mission (look steps only, nothing saved)

The Satellite program has its own commands: see Satellites.