X-Git-Url: https://git.giacomolli.uk/onechat/blobdiff_plain/9bd91a76e6277f7716e206ddb665dc5fe6f5b583..e1e48ba388c28105fff3b70c8ca02304f5d57f53:/README.rst

diff --git a/README.rst b/README.rst
index e386c67..3819e25 100644
--- a/README.rst
+++ b/README.rst
@@ -88,6 +88,19 @@ login`` and ``onechat probe`` refuse to start until it stops.
 The agent runs commands with bash as the user in its working directory,
 with no sandbox. It has the rights of the user, also on the token file.
 
+When the user asks for it, the agent starts subagents for long tasks.
+Each subagent has a name, such as ``GreenOtter``, and runs in the
+background while the agent answers other messages. It gets the view of
+the agent and its task, and it runs its tools as the agent does, in
+``agent/subagents/NAME/work``. A task in a repository gives the path of
+the repository. The steps of a subagent go to its own log in
+``agent/subagents/NAME``, not to the chat, and its final reply comes
+back to the agent as one message that starts with ``[NAME]``. The agent
+can send a subagent more messages: a running subagent reads them between
+its tool calls, and a finished one goes on from its log, and its reply
+comes back in the same way. Each model call of a subagent has the name
+in the ``agent`` field of ``agent/usage.jsonl``.
+
 ``agent/config.json`` holds the settings of the agent. The first start
 writes it with the defaults and a random ID. Do not change the ID: the
 prompt cache key comes from it.