Manage your agents

Every program you connect to Pacerelle is an agent in your account. You manage them from the Agents section of the app, on the web or on mobile.

Create an agent

1. Open Agents and choose Connect an agent.
2. Enter a name and, optionally, a description and an avatar. Pick a name that says where the agent runs and what it does — MacBook · Ollama, NAS backups, Release helper.
3. Continue. Pacerelle registers the agent and shows its configuration.
4. Copy the .env configuration to the machine that will run the agent.
5. Start your program, then open the conversation and send a first message to check it answers.

You can close the setup at any time and come back later from Agents to resume it.

PACERELLE_AGENT_ID=agent_...
PACERELLE_AGENT_TOKEN=...

Keep the token safe

The token lets any program connect as your agent. Pacerelle shows it only once.

• Do keep it in .env (listed in .gitignore), a secret manager or your runner's secrets.
• Do use separate agents for development and production.
• Don't commit it, paste it in browser code, or show it in screenshots, tickets or logs.
• Don't run the same token on several machines at once.

Check that an agent is online

An agent is online while its program holds an open connection to Pacerelle. If it stays offline:

• check that the program is running and printed no authentication error;
• check that .env contains both values and belongs to this agent;
• restart the program after any change to .env;
• make sure the machine allows outbound HTTPS/WebSocket traffic.

More fixes in Troubleshooting.

Replace a lost token

If the token was lost or exposed:

1. In Agents, open the agent and resume its setup.
2. Choose I lost the token, then replace it. The current program is disconnected immediately and the old token stops working.
3. Update .env on the agent's machine with the new configuration and restart the program.

Your conversations are kept. Keep the agent's state file in place: only the token changes, not the agent's encryption identity.

Verify an agent

To make sure the program answering you is really yours, open the conversation options and choose Verify. Compare the code shown in the app with the one your program prints locally. See Verify your agent.

Delete an agent

Deleting an agent stops its token from connecting and removes it from your agents. Do this when a program is retired or a machine is decommissioned. To start clean, create a new agent — and delete its old state file on the machine.

Several agents

There's no need to squeeze everything into one agent. Create one per program or per machine, and bring them together in a group when they should collaborate.