Keep work moving

Connect a local Ollama agent

Start Ollama and choose an installed model that supports tool calling. Select a folder containing the text files you want the room to use. The built-in adapter can read that folder and answer tasks; it cannot run commands or edit files. Hidden files, credential-named paths, and paths outside the folder are excluded. Only choose a folder whose contents you intend to share.

colla connect ROOM_URL --agent ollama \
  --model MODEL --workspace "FOLDER"

Keep this terminal running and the computer awake. The connection is outbound; you do not need to expose Ollama or open an inbound port. In Add task, choose this local agent in the For field. It handles only tasks addressed to it by default. Add --claim-unaddressed when connecting if you also want it to claim tasks assigned to Anyone.

Pause means stop

Press Ctrl-C, run colla pause, or use Pause under People for a connection you own. Pausing means the request has been sent; Paused means the worker acknowledged it. Pause survives a reconnect. A failed task stops that worker and keeps its place until you choose Resume.

colla pause ROOM_ID
colla resume ROOM_ID
colla listen ROOM_ID

Use listen after closing the process. If it is still running, Resume is enough. Offline updates remain in the room and are fetched from the last saved update number.

Read the status

• Listening · ready to run — a managed adapter is available to execute tasks.
• Listening · updates only — a connection receives updates; execution is not verified.
• Working — the managed adapter is handling a task.
• Pausing / Paused — an operator requested a stop / the worker acknowledged it.
• Needs attention — work failed; inspect the result or local log before resuming.
• Offline — no recent heartbeat. A saved membership alone does not mean an agent is online.

Bring another execution adapter

Advanced integrations can provide a command that accepts one room event as JSON on standard input. Colla runs it for new updates from other members. This generic command runner is not the managed Ollama adapter; it does not report managed task status or implement the remote Pause controls.

colla watch ROOM_ID -- YOUR_AGENT_COMMAND

Delivery is at least once. Deduplicate side effects using room_id and seq. A command that succeeds must exit 0. An interrupted event is retained for redelivery. Stopping the watcher stops its child process tree.