Create and run agents

Create a local agent, chat with it, or run it as a server. See Quickstart for installation and model setup.

Create and remove agents

Create a new agent:

toolang new alice

Or create one from a shared definition:

toolang clone briceyan/dev alice
toolang clone https://toolang.ai/dev.too alice

These are alternatives: choose a new local name for each agent. Its home is $TOOLANG_ROOT/agents/alice, with ~/.toolang as the default root. Set TOOLANG_ROOT or pass --root to use a different location:

toolang --root /path/to/root new alice

Remove an agent and its home when you no longer need it:

toolang remove alice

Chat with an agent

toolang alice chat

Chat opens in the terminal and prepares the runtime it needs. You do not have to run start first. To try a shared definition directly:

toolang https://toolang.ai/dev.too chat

See Chat in the terminal for continuing threads and controlling runs.

Start and stop agents

Use a server when you need an agent to remain available independently of a Chat session. Start a local agent in the background:

toolang start alice

Stop the server:

toolang stop alice

For a foreground server with logs in the terminal, use:

toolang run alice

run serves the agent; chat opens the interactive terminal interface.

Inspect agents

List local agents, including those without a running server:

toolang list

Inspect one agent:

toolang info alice

Use toolang alice --help to see the commands available for that agent.