guide
Prime Agent quickstart: first session and smoke test
After installation, run prime-agent and authenticate with a supported provider or API key. Create a first session, send a simple Python or shell request, and check that the persistent IPython kernel returns expected output. Then review the trust boundary before enabling autonomous or recursive features.
First-party announcement, documentation, release, or installer.
Prerequisites
You need a compatible provider, valid credentials, and a terminal that can execute the CLI. Start on a clean repository if you want the safest first test.
Log in
Authenticate through the provider flow or configure an API key before continuing. If the model selection screen shows an unsupported model, switch providers before you move on.
Start a session
prime-agent
# authenticate in the prompted provider flow
# then run a small Python command through the persistent kernelSmoke test
Ask the agent for a tiny Python calculation, a simple file read, or a short shell command. Confirm that the persistent kernel keeps state between two consecutive cells.
Next steps
After the smoke test, review providers, settings, and troubleshooting. Then enable recursive or autonomous features only if you understand the trust boundary.
Common failures
- bad credentials,
- unsupported model,
- missing Node runtime,
- or a kernel bootstrap error.