Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Getting Started

Toolang is an agent-oriented system with three layers:

  • a language
  • a runtime
  • a CLI

In Toolang, each runnable agent is defined by a top-level .too file inside a home.

Core ideas

  • A home is the private root directory of a Toolang setup.
  • An agent is one runnable .too file inside that home.
  • Caps are composable agent primitives such as skills, services, prompts, and psyches.
  • The runtime resolves caps, prepares model context, runs the model and tools, and persists local agent state.

Core commands

toolang check reviewer.too
toolang run reviewer
toolang serve reviewer
toolang start reviewer
toolang ps

Home layout

home/
  reviewer.too
  toolang.toml
  toolang.lock
  skills/
  services/
  prompts/
  psyches/
  .caps/
  agents/

Read Runtime Design next for the full model.