Kiln
Pages

Sessions

A button starts one session in the background, through hc. So it keeps running when you close the Herdr window. Each session has a name, such as t-001-build.

Each step starts clean. A session does its step, names the next step, and waits at its prompt. Type /exit to close it. While it is open, its button only says that it is running.

#Follow a session

Open a card, and open Agent sessions.

  • Show log shows the output of the session.
  • Follow in a tab opens the session in a tab, where you can read and type.

Use Follow in a tab for probe and accept, because they ask you questions. build and triage do not ask.

#What the words mean

WordIt means
runningThe agent is working.
needs youThe agent asked for an answer or a permission.
your turnThe agent finished its turn, and you have not looked.
idleThe agent waits, and you have looked.
endedThe session is over.

#What a session does first

scripts/factory-session.sh of the hub starts each session. It updates the hub and each clone in repos/. For a build, it makes a folder in .factory/builds/, claims the task, makes the branch, and runs the setup of each repository.

You can run it by hand, from the hub.

bash scripts/factory-session.sh probe T-001