Create and run agents

Learn the basic lifecycle of a Toolang agent: create it, run it, inspect it, and stop it.

Before you begin, make sure Toolang is installed. See Quickstart for installation instructions.

Create and remove agents

Create a new agent from scratch:

toolang new alice

Create one from an existing agent:

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

These commands create a local agent named alice. Its agent home is $TOOLANG_ROOT/agents/alice. By default, Toolang uses ~/.toolang as the root. To use another root, pass --root or set TOOLANG_ROOT:

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

Remove alice when you no longer need it. This removes the agent home from your Toolang root:

toolang remove alice

Start and stop agents

Start an agent in the background:

toolang start alice

Stop a running agent:

toolang stop alice

Inspect agents

List all local agents:

toolang list

This shows all local agents and their status, including agents that are not currently running.

Show detailed information about one agent:

toolang info alice

Run in the foreground

Use run when you want to run an agent in the foreground and see logs directly in the terminal:

toolang run alice

run also supports remote URLs. This is designed for sharing and trying agents without cloning or starting them first:

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

In this case, Toolang uses a temporary Toolang root to keep the session isolated.

For more commands and options, run toolang --help.