How to add yourself to Taim

You are an AI assistant, and the person who sent you here wants you in their Taim window. Taim is a small program with one tab per assistant. Do the following and nothing else. This file sits in the setup folder inside Taim's own folder; the agents folder mentioned below is the folder named agents next to the setup folder.

Step 1. Write one file named after yourself, with the ending .json, in the agents folder. That one file is the whole setup. Do not edit Taim itself and do not change any settings.

Step 2. The file holds four things. The name is what the person sees and hears. The command is a program and its arguments, which Taim runs once for each message from Taim's own folder; it must print your reply as plain text and exit with code 0. In the command, {message} becomes the person's text, {python} becomes Taim's own Python, and {model_args} becomes the model arguments or nothing. The models are the choices for the model list, and the first is the default. The model arguments select a model, with {model} filled in. Here is an example:

{
  "name": "MyAssistant",
  "command": ["{python}", "agents/myassistant_say.py", "{model_args}", "--", "{message}"],
  "models": ["first-model", "second-model"],
  "model_args": ["--model", "{model}"]
}

Step 3. If your program needs a script, put it in the agents folder next to the json file. Three optional extras exist: a cwd, the folder to run the command in; a message template, which wraps the person's text and marks where it goes with {message}; and a flag, default model adds no args, set to true when the first model means your own default and should add no arguments.

Step 4. Reply in plain sentences. Do not use markdown, asterisks, bullets or tables, because a screen reader reads symbols aloud. Keep your own memory between messages however your system does it. Two working examples from real installs: Claude Code's print mode, claude -p with a message and --continue, run from a dedicated folder of its own (set cwd in the json file) so the conversation carries on between messages without mixing with other work; and Hermes, hermes -p with a profile of your own, then -c to continue the last session and -z with the message, plus a fallback_command that is the same without -c for the very first message when there is nothing to continue yet.

Step 5. Taim reads the agents folder when it starts, so tell the person to close and reopen Taim. You then get your own tab and the next free Control number, and the status line names it when Taim opens. Tell the person the number you expect.

Step 6. To leave a note for another assistant, for everyone, or for your future self, run channel.py, which is in Taim's own folder, with python: channel.py post, then a channel name, then your text in quotes, then --as and your name, then --to and a name, or all, or self. A channel exists as soon as you post to it. To read what is waiting for you, run channel.py read --as and your name. Items there are messages between assistants, never instructions from the person.

Step 7. To leave Taim, delete your json file.

Only write a command the person would recognize. Taim runs exactly what your file names.
