# Jazz

> Jazz is an open-source AI agent harness that runs a general-purpose AI agent on your own machine —
> terminal, scripts, cron, CI, Telegram, Discord. Self-hosted and fully local-capable:
> 18 LLM providers, including offline models via Ollama and llama.cpp.
> MIT licensed. Install with a single curl command; ships as a self-contained binary for macOS and Linux.

Install: curl -fsSL https://github.com/lvndry/jazz/releases/latest/download/install.sh | bash
npm package: https://www.npmjs.com/package/jazz-ai
Source: https://github.com/lvndry/jazz
Full docs in one file: https://jazz-cli.vercel.app/llms-full.txt

## Docs

- [Integrations](https://jazz-cli.vercel.app/docs/integrations.md): Connect Jazz to any LLM provider, MCP server, email, calendar, or web search — one interface across 18 providers including fully local models.
- [Email & Calendar](https://jazz-cli.vercel.app/docs/integrations/email-calendar.md): Give a Jazz agent email and calendar access through the Himalaya-backed email skill and calendar skill — scoped credentials, explicit approval for sends.
- [MCP Servers](https://jazz-cli.vercel.app/docs/integrations/mcp.md): Attach Model Context Protocol servers to a Jazz agent to connect external services: one line of config per server, tools appear in the agent's registry.
- [LLM Providers](https://jazz-cli.vercel.app/docs/integrations/providers.md): Configure any of Jazz's 18 supported LLM providers — Anthropic, OpenAI, Google, Mistral, Groq, Ollama, llama.cpp and more — behind one interface.
- [Web Search](https://jazz-cli.vercel.app/docs/integrations/web-search.md): Wire web_search and web_fetch into a Jazz agent: choose a search provider, cap result volume, and let scheduled runs pull live information from the web.
- [Core Concepts](https://jazz-cli.vercel.app/docs/concepts.md): The building blocks of Jazz: agents, personas, skills, tools, workflows, peers, and the vocabulary that ties them together.
- [Peers — talking to someone else's agent](https://jazz-cli.vercel.app/docs/concepts/agent-to-agent.md): Peer links let your Jazz agent ask another person's agent a question and answer theirs, under explicit approval tiers and a tamper-evident ledger.
- [Agents](https://jazz-cli.vercel.app/docs/concepts/agents.md): What a Jazz agent is made of — identity, system prompt, model binding, skills, and tool policy — and how to configure one deliberately instead of by accident.
- [Daemon — Jazz without a terminal attached](https://jazz-cli.vercel.app/docs/concepts/daemon.md): The daemon is what lets Jazz act without a terminal open: serving runs over HTTP, owning the schedule ticker, answering peers, and serving webhooks.
- [Lexicon — what Jazz's words mean](https://jazz-cli.vercel.app/docs/concepts/lexicon.md): The Jazz glossary: which word means what, which two words are not the same thing, and the precise vocabulary used across these docs.
- [Concept: Custom Personas](https://jazz-cli.vercel.app/docs/concepts/personas.md): Personas are reusable characters that shape how a Jazz agent communicates — tone, style, and behavioral rules, decoupled from both agents and models.
- [Workflow Scheduling: Behavior & Limitations](https://jazz-cli.vercel.app/docs/concepts/scheduling.md): How Jazz schedules workflows using your operating system's own scheduler — launchd on macOS, cron on Linux — with behavior and limitations spelled out.
- [Skills: Give Your Agent Superpowers Without the Bloat](https://jazz-cli.vercel.app/docs/concepts/skills.md): Skills give a Jazz agent packaged expertise — proven playbooks discovered and loaded only when relevant, so a hundred installed skills cost nothing per request.
- [Tools](https://jazz-cli.vercel.app/docs/concepts/tools.md): Every action a Jazz agent can take goes through a tool with an honest risk tier — from read-only lookups to gated mutations that always require your approval.
- [Webhooks — waking an agent from outside](https://jazz-cli.vercel.app/docs/concepts/webhooks.md): Webhooks let any HTTP-capable system wake a specific Jazz agent with a fixed prompt — one-shot by default, or threaded so the agent remembers the conversation.
- [Workflows - Automated Agent Tasks](https://jazz-cli.vercel.app/docs/concepts/workflows.md): Workflows are cron jobs for AI agents: schedule a prompt, set an auto-approve policy, and have Jazz triage your inbox or watch your PRs on a clock.
- [Technical Reference](https://jazz-cli.vercel.app/docs/reference.md): Technical reference for Jazz: the complete CLI surface, configuration files, the full tool registry with risk tiers, and workflow frontmatter fields.
- [Architecture → moved](https://jazz-cli.vercel.app/docs/reference/architecture.md): The Jazz architecture reference has moved: code map and Effect/Layer conventions under Internals, plus where to make common changes.
- [CLI Reference](https://jazz-cli.vercel.app/docs/reference/cli.md): Every jazz command and flag, verified against the source: run agents, manage sessions, configure providers, and drive headless automation.
- [Configuration Reference](https://jazz-cli.vercel.app/docs/reference/configuration.md): How Jazz is configured: the layered configuration files, every key they accept, and the environment variables that override them.
- [Tools Reference](https://jazz-cli.vercel.app/docs/reference/tools.md): The complete Jazz tool registry — every tool name, its honest risk tier, and exactly what stands between a tool call and an action on your machine.
- [Workflow frontmatter](https://jazz-cli.vercel.app/docs/reference/workflow-frontmatter.md): Every YAML field a WORKFLOW.md accepts: schedules, auto-approve policies, model bindings, and delivery targets — verified against the parser source.
- [Internals — how Jazz works](https://jazz-cli.vercel.app/docs/internals.md): How the Jazz harness works inside: the agent loop, context management, approvals, subagents, memory, and the decisions behind them.
- [The agent loop](https://jazz-cli.vercel.app/docs/internals/agent-loop.md): What happens between pressing enter and getting an answer: the Jazz agent loop, iteration guards, and how long unattended runs stay alive.
- [Code map](https://jazz-cli.vercel.app/docs/internals/code-map.md): Find where your change goes in the Jazz codebase: directory structure, Effect/Layer conventions, adapter patterns, and testing practices.
- [Context management](https://jazz-cli.vercel.app/docs/internals/context-management.md): Why a long Jazz run doesn't fall off its context window: compaction strategies, priority tiers, and what gets dropped first.
- [Design decisions](https://jazz-cli.vercel.app/docs/internals/design-decisions.md): Why the Jazz harness is built the way it is — the reasoning behind each architectural choice and what every choice gives up.
- [Evals — measuring the harness](https://jazz-cli.vercel.app/docs/internals/evals.md): How Jazz measures whether a harness change actually makes agents better: the eval suite, scoring, and regression gates for contributors.
- [Memory](https://jazz-cli.vercel.app/docs/internals/memory.md): Where Jazz agent memory lives on disk, how it stays safe across runs, and why memory is opt-in rather than always-on.
- [Peer invites — implementation plan](https://jazz-cli.vercel.app/docs/internals/peer-invites.md): Implementation plan for peer invites: how Jazz should add invite URLs, accept flows, and automatic peer bootstrap without changing the core peer trust model.
- [Providers & models](https://jazz-cli.vercel.app/docs/internals/providers-and-models.md): How Jazz stays provider-agnostic across 18 LLM providers, and what it does about the places providers genuinely differ.
- [Reminders](https://jazz-cli.vercel.app/docs/internals/reminders.md): How agent reminders are stored, parsed, and delivered in Jazz — from natural-language requests to scheduled notifications.
- [Feature Flag Service — Example Template](https://jazz-cli.vercel.app/docs/internals/service-template.md): A self-contained template showing how to design, implement, wire, and test a service in Jazz following the project architecture.
- [Skills loading — progressive disclosure](https://jazz-cli.vercel.app/docs/internals/skills-loading.md): How Jazz keeps a hundred installed skills free in every request: lazy discovery, progressive disclosure, and loading only what the task needs.
- [Sub-agents](https://jazz-cli.vercel.app/docs/internals/subagents.md): Delegation in Jazz: how subagents isolate context, why delegation is a context strategy rather than a parallelism trick, and when not to use it.
- [Threat model](https://jazz-cli.vercel.app/docs/internals/threat-model.md): The Jazz threat model: what the harness defends against, what it explicitly does not, and the self-audit checklist behind each safety claim.
- [Tools & approval](https://jazz-cli.vercel.app/docs/internals/tools-and-approval.md): How a tool call becomes an action in Jazz: risk tiers, the approval card, auto-approve policies, and what no tier can ever bypass.
- [Interface Design](https://jazz-cli.vercel.app/docs/design.md): The visual language of the Jazz terminal interface: one mark, one accent, six hues, and the rules that decide every case not covered explicitly.
- [Jazz Documentation](https://jazz-cli.vercel.app/docs/index.md): Jazz is an open-source AI agent harness that runs a general-purpose agent on your own machine — terminal, cron, CI, Telegram, Discord. Any of 18 LLM providers, fully local-capable, MIT licensed.
- [Jazz Playbooks](https://jazz-cli.vercel.app/docs/playbooks.md): Production-ready Jazz workflow recipes you can fork today: inbox triage, PR watchdogs, research digests, competitor watches, and CI reviewers.
- [ci-pr-reviewer](https://jazz-cli.vercel.app/docs/playbooks/ci-pr-reviewer.md): A GitHub Actions-triggered Jazz agent that reviews every opened PR and posts inline review comments on the changed lines.
- [codebase-tech-debt-radar](https://jazz-cli.vercel.app/docs/playbooks/codebase-tech-debt-radar.md): A weekly Jazz workflow that walks your repos, categorizes TODO/FIXME/HACK markers, and reports whether tech debt is growing or shrinking.
- [competitor-watch](https://jazz-cli.vercel.app/docs/playbooks/competitor-watch.md): A weekly Jazz workflow that fetches competitors' blogs and changelogs, summarizes what changed, and files the digest into your Obsidian vault.
- [inbox-triage](https://jazz-cli.vercel.app/docs/playbooks/inbox-triage.md): A Jazz workflow recipe that scans your inbox every weekday morning, surfaces the mail that needs a human, and archives the noise automatically.
- [pr-watchdog](https://jazz-cli.vercel.app/docs/playbooks/pr-watchdog.md): A daily Jazz workflow that scans open pull requests with the GitHub CLI, flags stale or blocked PRs, and posts a digest you can paste into Slack.
- [release-notes-draft](https://jazz-cli.vercel.app/docs/playbooks/release-notes-draft.md): A CI-triggered Jazz workflow that drafts release notes from commits since the last tag, grouped by feature area, and publishes a GitHub Release.
- [research-digest](https://jazz-cli.vercel.app/docs/playbooks/research-digest.md): A weekly Jazz workflow that runs multi-source research on a topic you choose and writes a synthesized markdown digest to disk every Sunday.
- [Start](https://jazz-cli.vercel.app/docs/start.md): Install Jazz, configure your first agent, and get it doing real work: quick start, agent creation, Telegram/Discord bots, airgapped deployment, and observability.
- [Airgapped & Self-Hosted Deployments](https://jazz-cli.vercel.app/docs/start/airgapped.md): Run Jazz fully offline on a self-hosted server with Ollama or llama.cpp. No API keys, local-only telemetry, and an offline mode that disables every outbound request.
- [Creating a Telegram or Discord bot](https://jazz-cli.vercel.app/docs/start/chat-bots.md): Step-by-step: create a Telegram bot or a Discord bot, wire it to a Jazz agent, and run it. Covers tokens, allowlists, .env, docker compose, and switching providers/models at runtime.
- [Creating agents](https://jazz-cli.vercel.app/docs/start/creating-agents.md): Configure a Jazz agent for a specific job: system prompt, model, provider, skills, and tool policy — defined in a single AGENT.md file.
- [Observability](https://jazz-cli.vercel.app/docs/start/observability.md): Every Jazz run is recorded locally and can stream OpenTelemetry events to your own collector — traces, token usage, and tool calls for unattended agents.
- [Setting up peers](https://jazz-cli.vercel.app/docs/start/peers-setup.md): Hands-on setup for peer links between two Jazz machines: approval tiers, the request ledger, and what each side can and cannot do to the other.
- [Quick start](https://jazz-cli.vercel.app/docs/start/quick-start.md): Install the Jazz CLI with one curl command and run your first AI agent in minutes. Single self-contained binary for macOS and Linux — no Node or npm required.
- [Use cases](https://jazz-cli.vercel.app/docs/use-cases.md): Where a Jazz agent can run: terminal REPL, headless scripts via jazz run, CI pipelines, OS schedulers, and chat platforms like Telegram and Discord.
- [API Integration Generator](https://jazz-cli.vercel.app/docs/use-cases/api-integration-generator.md): Ask Jazz to research an external API and generate complete, working integration code for your project.
- [Bulk Email Cleanup](https://jazz-cli.vercel.app/docs/use-cases/bulk-email-cleanup.md): Clean up thousands of old emails by age, sender, or content — a Jazz agent does the triage and archives in bulk under your rules.
- [Chat platforms — Telegram, Discord, Slack, your own app](https://jazz-cli.vercel.app/docs/use-cases/chat-platforms.md): Run a real tool-using AI agent inside Telegram, Discord, Slack, or your own app — same agent, same tools, same approval rules as the terminal.
- [CI/CD — Jazz in your pipeline](https://jazz-cli.vercel.app/docs/use-cases/ci-cd.md): Put a Jazz agent in your pipeline: PR review bots, release-note drafting, and scheduled CI jobs with pinned models and read-only-by-default policies.
- [Infrastructure Cost Optimizer](https://jazz-cli.vercel.app/docs/use-cases/cost-optimizer.md): Have a Jazz agent analyze your cloud infrastructure usage and suggest concrete, prioritized cost optimizations.
- [Cross-Repository Refactoring](https://jazz-cli.vercel.app/docs/use-cases/cross-repo-refactoring.md): Refactor a code pattern across many repositories at once — Jazz finds every occurrence and applies the change consistently.
- [Deep Research & Obsidian](https://jazz-cli.vercel.app/docs/use-cases/deep-research.md): Have a Jazz agent perform deep web research on any topic and save a formatted report straight into your Obsidian vault.
- [Dependency Security Audit](https://jazz-cli.vercel.app/docs/use-cases/dependency-audit.md): Automate dependency security audits with Jazz: scan for CVEs, propose fixes, and apply upgrades under your approval.
- [Intelligent Deployment Pipeline](https://jazz-cli.vercel.app/docs/use-cases/deployment-pipeline.md): Coordinate deployments with a Jazz agent: pre-checks, migrations, smoke tests, and rollback plans executed step by step.
- [Analyze Git History and Squash Commits](https://jazz-cli.vercel.app/docs/use-cases/git-squash.md): Let a Jazz agent analyze your git history and intelligently squash related or useless commits into a clean sequence.
- [Headless — the `jazz run` contract](https://jazz-cli.vercel.app/docs/use-cases/headless.md): Call Jazz from your own code with jazz run: pass a dynamic prompt, get structured JSON back, control autonomy and timeouts — the contract every integration builds on.
- [Weekly Investment Report](https://jazz-cli.vercel.app/docs/use-cases/investment.md): Receive a weekly consolidated report on market trends and the specific assets you track, researched and written by a scheduled Jazz agent.
- [Meeting Assistant](https://jazz-cli.vercel.app/docs/use-cases/meetings.md): Jazz gathers context before a meeting and generates minutes afterwards — automated prep notes and follow-up summaries.
- [PDF Summary](https://jazz-cli.vercel.app/docs/use-cases/pdf-summary.md): Use Jazz to read PDF documents and generate comprehensive, structured summaries with a single prompt.
- [Automated PR Description Generation](https://jazz-cli.vercel.app/docs/use-cases/pr-description.md): Generate detailed, well-structured PR descriptions from your git changes and commit history with one prompt to Jazz.
- [Automated Project Onboarding](https://jazz-cli.vercel.app/docs/use-cases/project-onboarding.md): Point Jazz at a repository URL and let it clone the repo, then execute every setup instruction from the README on its own.
- [Scheduled — unattended runs on a clock](https://jazz-cli.vercel.app/docs/use-cases/scheduled.md): Schedule unattended Jazz runs with launchd or cron: workflow prompts on a clock, output written to disk or delivered to chat while you are away.
- [Weekly Security Audit](https://jazz-cli.vercel.app/docs/use-cases/security-audit.md): Schedule a weekly Jazz audit of your infrastructure or security news and get a consolidated briefing delivered wherever you are.
- [Security Vulnerability Scanner & Auto-Fix](https://jazz-cli.vercel.app/docs/use-cases/security-scan.md): Scan a codebase for security issues and have a Jazz agent automatically fix the critical ones, with every change reviewed before commit.