docs blog library
github

Jazz concepts

Jazz can work on files, use your tools, create visuals, and keep jobs running after a turn ends. These concepts explain how to configure that work and choose the right controls.

Start with Agents. For ongoing work, read Goals and loops; for charts and interactive pages, read Compositions.

Agents and capabilities

  • An agent selects a model, persona, capabilities, and restrictions.
  • A persona supplies reusable behavioral instructions.
  • A tool lets the model inspect or change something.
  • A skill teaches the model how to complete a kind of work.
  • Model companions use specialist models to understand or generate images, audio, and video.
  • The Browser Use tools let an agent read and act on real web pages, including ones that need JavaScript or a login.
  • Computer use (experimental) lets an agent look at and act in desktop apps you grant on your Mac, while you watch.
  • Subagents delegate bounded work to child runs with isolated context.
  • MCP, custom tools, and plugins extend the agent’s capabilities.

Conversations and state

  • A conversation carries dialogue; work state, todos, the scratchpad, and memory each provide a different kind of continuity.
  • Why memory works this way explains what Jazz learns about you, how scopes keep contexts apart, and why saves must quote you.
  • Context management preserves working state, compacts history, and detects repetitive tool calls.
  • A composition is a chart, dashboard, calculator, or interactive HTML page you can open or share.
  • An artifact is a file a run produced, labelled with whether a model generated it or it was rendered from data.

Automation

  • Goals and loops keep working toward an objective or rerun a prompt until its purpose is met.
  • Starting runs explains commands, workflows, schedules, and event triggers.
  • A workflow packages a prompt with repeatable run settings.
  • Deferred work covers wake triggers, reminders, and background jobs that outlast a turn.

Connections and control

  • A peer is another explicitly trusted Jazz agent.
  • A webhook is a fixed, authenticated HTTP door onto an agent.
  • Remote handoff moves a conversation to your SSH server and brings it back with its file changes.
  • The daemon is the process that serves runs, webhooks, and peer requests over HTTP when no terminal is attached.
  • Budgets cap iterations, cost, tokens, and time, including daily and monthly unattended spend.
  • Approvals gate actions and let unattended runs park for a human decision.

Compare where Jazz runs, follow a guide, or look up a term in the lexicon.

machine-readable: /docs/concepts.md · /llms.txt · /llms-full.txt