{"id":39907673,"url":"https://github.com/lvndry/jazz","last_synced_at":"2026-05-03T13:01:56.948Z","repository":{"id":314658230,"uuid":"1056319648","full_name":"lvndry/jazz","owner":"lvndry","description":"Jazz is a powerful CLI that lets you create autonomous AI agents with real-world capabilities.","archived":false,"fork":false,"pushed_at":"2026-04-28T17:19:02.000Z","size":15386,"stargazers_count":44,"open_issues_count":0,"forks_count":8,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-28T18:32:23.540Z","etag":null,"topics":["agent","agentskills","ai","ai-agents","ai-workflow","automation","cli","effect-ts","llm","mcp","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lvndry.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/funding.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/security.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"github":"lvndry","buy_me_a_coffee":"lvndry"}},"created_at":"2025-09-13T20:50:28.000Z","updated_at":"2026-04-28T17:19:06.000Z","dependencies_parsed_at":"2025-09-13T22:36:11.461Z","dependency_job_id":null,"html_url":"https://github.com/lvndry/jazz","commit_stats":null,"previous_names":["lvndry/crush"],"tags_count":58,"template":false,"template_full_name":null,"purl":"pkg:github/lvndry/jazz","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lvndry%2Fjazz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lvndry%2Fjazz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lvndry%2Fjazz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lvndry%2Fjazz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lvndry","download_url":"https://codeload.github.com/lvndry/jazz/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lvndry%2Fjazz/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32569714,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T06:36:36.687Z","status":"ssl_error","status_checked_at":"2026-05-03T06:36:09.306Z","response_time":103,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","agentskills","ai","ai-agents","ai-workflow","automation","cli","effect-ts","llm","mcp","typescript"],"created_at":"2026-01-18T16:01:33.350Z","updated_at":"2026-05-03T13:01:56.942Z","avatar_url":"https://github.com/lvndry.png","language":"TypeScript","funding_links":["https://github.com/sponsors/lvndry","https://buymeacoffee.com/lvndry"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Jazz\n\n[![TypeScript](https://img.shields.io/badge/TypeScript-100%25-blue.svg)](https://www.typescriptlang.org/) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![npm version](https://img.shields.io/npm/v/jazz-ai.svg)](https://www.npmjs.com/package/jazz-ai)\n\n### Your terminal. Your agent. Your rules.\n\nJazz is an AI agent that lives in your terminal and actually does things.\nNot a chatbot. Not a wrapper around an API. A personal assistant you control,\nthat reads your files, manages your git, searches the web, handles your email,\nand automates the workflows you're tired of doing by hand.\n\n[Quick Start](#quick-start) · [What Can It Do?](#what-can-it-do) · [Workflows](#workflows-automate-everything) · [CI/CD](#we-use-jazz-to-build-jazz) · [Docs](docs/README.md) · [Discord](https://discord.gg/yBDbS2NZju)\n\n\u003c/div\u003e\n\n---\n\n## Why Jazz?\n\nBecause your terminal should be smarter than a blinking cursor.\n\nJazz is a personal assistant that lives where you already work. It can read your filesystem, manage your git repos, search the web, handle your email, run shell commands, talk to APIs -- and it does all of it autonomously, step by step, without you having to hold its hand. It's LLM provider agnostic, supports agent skills, and connects to anything through MCP.\n\nTell it to \"analyze yesterday's unread emails and archive the newsletters\" -- it connects to Gmail, reads your inbox, categorizes messages, and archives them. Tell it to \"commit my changes with a good message\" -- it runs `git diff`, reads the changes, writes a semantic commit message, and commits. Tell it to \"find all security vulnerabilities in this codebase\" -- it scans your files, analyzes patterns, and gives you a prioritized report.\n\nYou describe what you want. Jazz figures out how to do it.\n\n---\n\n## Quick Start\n\n```bash\n# Install\nnpm install -g jazz-ai\nbun add -g jazz-ai\npnpm add -g jazz-ai\nyarn global add jazz-ai\n\n# Start chatting\njazz\n```\n\nThat's it. Jazz walks you through provider setup on first run.\n\n\u003e **Start using Jazz for free** -- choose [OpenRouter](https://openrouter.ai) as your provider and select the [`Free Models Router`](https://openrouter.ai/openrouter/free). No credit card, no commitment.\n\nKeep it updated:\n\n```bash\njazz update\n```\n\n---\n\n## What Can It Do?\n\n### The short answer: almost anything you can describe.\n\nJazz understands your filesystem, your git history, your shell, HTTP APIs, the web, PDFs and it can connect to external services through MCP. But capabilities are just the foundation. What makes Jazz different is how it _combines_ them to solve your actual problems.\n\n### Real examples, real workflows\n\n**Development**\n\n```\n\u003e review the last 5 commits and flag anything that looks risky\n\u003e find all TODO comments, group them by priority, and create a summary\n\u003e refactor this function to use async/await and update all callers\n\u003e generate a PR description from the current branch diff\n```\n\n**Email \u0026 Communication**\n\n```\n\u003e check my unread emails, summarize anything important, archive the rest\n\u003e draft a reply to the latest email from Sarah about the project timeline\n```\n\n**Research \u0026 Analysis**\n\n```\n\u003e research the latest developments in WebAssembly and write a 2-page summary\n\u003e compare React Server Components vs Astro islands architecture with pros and cons\n\u003e analyze this PDF report and extract the key financial metrics\n```\n\n**Knowledge Management**\n\n```\n\u003e do deep research on the Three-Body Problem and write it in my Obsidian vault\n```\n\n### LLM Provider Agnostic\n\nJazz doesn't lock you in. Use whichever model fits the task or switch mid-conversation. Run locally with Ollama, go through OpenRouter for access to hundreds of models, or plug in your own endpoint.\n\nOpenAI, Anthropic, Google, Mistral, xAI, DeepSeek, Groq, Cerebras, Fireworks, TogetherAI, Ollama, llama.cpp, OpenRouter, and more.\n\n### MCP: Connect to Everything\n\nJazz speaks [Model Context Protocol](https://modelcontextprotocol.io/). One config block, and your agent can talk to any MCP-compatible service:\n\nSimply run `jazz mcp add` and input the MCP configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"notion\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.notion.com/mcp\"]\n    },\n    \"github\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol/server-github\"]\n    }\n  }\n}\n```\n\n### Skills: Extend Your Agent\n\nSkills are packaged expertise your agent loads on demand—proven playbooks for complex tasks instead of winging it every time. Think deep research with multi-source verification, structured code review, meeting notes that follow your format, PR descriptions from your conventions. You get consistency and domain expertise without stuffing the context window.\n\nJazz ships with **20+ built-in skills**—code review, deep research, email, calendar, PR descriptions, documentation, browser automation, Obsidian, budgeting, and more. Add your own from the ecosystem: Jazz follows the [`.agents` convention](https://agentskills.io), so any skill works. Run `npx skills add` to browse and install, or drop a skill in `~/.jazz/skills/` (global) or `./skills/` (project-local). Use `/skills` in chat to browse what's available.\n\n---\n\n## Workflows: Automate Everything\n\nA workflow is a Markdown file that describes what your agent should do, when it should do it, and how much autonomy it gets. Schedule them with cron, run them headless, and let Jazz handle the boring parts of your day.\n\n### Built-in Workflows\n\nJazz ships with workflows ready to go:\n\n| Workflow             | Schedule      | What it does                                                      |\n| -------------------- | ------------- | ----------------------------------------------------------------- |\n| **email-cleanup**    | Hourly        | Archive newsletters, organize promotions, flag important messages |\n| **tech-digest**      | Daily         | Scan AI/tech news sources and compile a personalized digest       |\n| **weather-briefing** | Every morning | Weather forecast + outfit recommendations for your location       |\n| **market-analysis**  | Daily         | Stock/crypto analysis with buy/sell signals                       |\n\n### Create Your Own\n\nAny task you do repeatedly can become a workflow. Write a `WORKFLOW.md`:\n\n```yaml\n---\nname: daily-standup-prep\ndescription: Prepare my daily standup notes\nschedule: \"0 9 * * 1-5\" # 9 AM, weekdays\nagent: my-dev-agent\nautoApprove: read-only\n---\n```\n\n```markdown\nCheck my git activity from yesterday across all repos in ~/projects/.\nSummarize what I worked on, what PRs I opened or reviewed,\nand any blockers I mentioned in commit messages.\nFormat it as bullet points I can paste into Slack.\n```\n\nThen schedule it:\n\n```bash\njazz workflow schedule daily-standup-prep\n```\n\nJazz uses `launchd` on macOS and `cron` on Linux. If your machine was asleep when a workflow was supposed to run, Jazz can catch up automatically on next launch.\n\n### Auto-Approve Policies\n\nControl how much autonomy each workflow gets:\n\n| Policy      | What it auto-approves                       |\n| ----------- | ------------------------------------------- |\n| `false`     | Nothing -- always asks                      |\n| `read-only` | Reading files, searching, web requests      |\n| `low-risk`  | + archiving email, creating calendar events |\n| `high-risk` | + file changes, shell commands, git push    |\n\n---\n\n## We use Jazz to build Jazz.\n\nJazz isn't just a local tool. It runs in CI/CD pipelines with `--output raw` and `--auto-approve` flags, purpose-built for automation.\n\n### Automated Code Review\n\nEvery pull request to Jazz gets reviewed by a Jazz agent. The [`jazz.yml`](.github/workflows/jazz.yml) workflow:\n\n1. Installs `jazz-ai` in the CI runner\n2. Runs a code review workflow against the PR diff\n3. Posts **inline review comments** directly on the PR -- on specific lines, with context\n\n```yaml\n# .github/workflows/jazz.yml (simplified)\n- name: Run Jazz code review\n  run: jazz --output raw workflow run code-review --auto-approve --agent ci-reviewer\n  env:\n    OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}\n```\n\nComment `/jazz-review` on a pull request to trigger a review on demand, or `/jazz \u003crequest\u003e` to ask the PR assistant anything.\nThe review agent checks for correctness, security issues, TypeScript best practices, Effect-TS patterns, and performance concerns. Real reviews, on real code, every PR.\n\n### Automated Release Notes\n\nEvery release gets its notes written by Jazz. The [`release.yml`](.github/workflows/release.yml) workflow:\n\n1. Bumps the version and creates a git tag\n2. Runs a Jazz agent to analyze all commits since the last release\n3. Generates release notes grouped by feature area\n4. Creates the GitHub Release with those notes\n\nNo more \"what changed in this release?\" -- Jazz reads the commits, understands the changes, and writes release notes that actually make sense.\n\n### Run Jazz in Your Own Pipelines\n\n```yaml\n# Your .github/workflows/review.yml\nname: AI Code Review\non: pull_request\n\njobs:\n  review:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v4\n        with:\n          fetch-depth: 0\n\n      - run: npm install -g jazz-ai\n\n      - name: Run review\n        run: jazz --output raw workflow run my-review --auto-approve\n        env:\n          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}\n```\n\nSee [`.github/jazz/`](.github/jazz/) for the full agent configs and workflow templates we use.\n\n---\n\n## You Stay in Control\n\nJazz is powerful, but it never acts without your say-so.\n\n**Requires approval:** File changes, git commits, shell commands, sending emails, API mutations\n**Runs freely:** Reading files, searching, analyzing code, web lookups, viewing data\n\nEvery action is logged. You see exactly what Jazz wants to do before it does it. You can review, approve, deny, or modify. Full audit trail, always.\n\nCredentials are stored securely (OAuth2 for Gmail, API keys in config). Nothing is logged or exposed.\n\n---\n\n## Command Reference\n\n**Agents**\n\n| Command                       | Description                |\n| ----------------------------- | -------------------------- |\n| `jazz`                        | Start chatting             |\n| `jazz agent create`           | Create a new agent         |\n| `jazz agent list`             | List all agents            |\n| `jazz agent show \u003cid\u003e`        | Show agent details         |\n| `jazz agent edit \u003cid\u003e`        | Edit an agent              |\n| `jazz agent delete \u003cid\u003e`      | Delete an agent            |\n| `jazz agent chat \u003cname\u003e`      | Chat with a specific agent |\n\n**Workflows**\n\n| Command                           | Description                    |\n| --------------------------------- | ------------------------------ |\n| `jazz workflow list`              | List available workflows       |\n| `jazz workflow show \u003cname\u003e`       | Show workflow details          |\n| `jazz workflow run \u003cname\u003e`        | Run a workflow                 |\n| `jazz workflow schedule \u003cname\u003e`   | Schedule a workflow            |\n| `jazz workflow unschedule \u003cname\u003e` | Remove a workflow schedule     |\n| `jazz workflow scheduled`         | List scheduled workflows       |\n| `jazz workflow catchup`           | Run missed scheduled workflows |\n| `jazz workflow history [name]`    | View workflow run history      |\n\n**MCP, Personas \u0026 Config**\n\n| Command                    | Description            |\n| -------------------------- | ---------------------- |\n| `jazz mcp add`             | Add an MCP server      |\n| `jazz mcp list`            | List MCP servers       |\n| `jazz mcp remove`          | Remove an MCP server   |\n| `jazz mcp enable`          | Enable an MCP server   |\n| `jazz mcp disable`         | Disable an MCP server  |\n| `jazz persona create`      | Create a persona       |\n| `jazz persona list`        | List personas          |\n| `jazz persona show \u003cid\u003e`   | Show persona details   |\n| `jazz persona edit \u003cid\u003e`   | Edit a persona         |\n| `jazz persona delete \u003cid\u003e` | Delete a persona       |\n| `jazz config show`         | View configuration     |\n| `jazz config get \u003ckey\u003e`    | Get a config value     |\n| `jazz config set \u003ckey\u003e`    | Set a config value     |\n| `jazz update`              | Update to latest version |\n\n**In-chat commands:** `/tools`, `/skills`, `/model`, `/mode`, `/cost`, `/context`, `/compact`, `/switch`, `/workflows`, and more. Type `/help` during chat.\n\n---\n\n## Built to Be Reliable\n\nJazz is 100% TypeScript with [Effect-TS](https://effect.website/) under the hood. That means every error has a recovery path, every side effect is tracked, and nothing silently fails.\n\nIt manages its own context window (auto-summarizes when things get long), delegates deep tasks to sub-agents, and gracefully recovers from timeouts and failures. You can throw complex, multi-step problems at it and trust that it won't fall apart halfway through.\n\n---\n\n## Documentation \u0026 Community\n\n|                        |                                                                  |\n| ---------------------- | ---------------------------------------------------------------- |\n| **Full Documentation** | [`docs/README.md`](docs/README.md)                               |\n| **Tools Reference**    | [`docs/tools-reference.md`](docs/tools-reference.md)             |\n| **Integrations**       | [`docs/integrations.md`](docs/integrations.md)                   |\n| **Examples** (20+)     | [`examples/`](examples/)                                         |\n| **Research \u0026 Roadmap** | [`docs/exploration/`](docs/exploration/)                         |\n| **Discord**            | [Join the community](https://discord.gg/yBDbS2NZju)              |\n| **Discussions**        | [GitHub Discussions](https://github.com/lvndry/jazz/discussions) |\n| **Issues**             | [Report a bug](https://github.com/lvndry/jazz/issues)            |\n\n---\n\n## Contributing\n\nWe welcome contributions -- bug fixes, docs, tests, features, and ideas.\n\nSee [`CONTRIBUTING.md`](CONTRIBUTING.md) for the contributor guide.\n\n---\n\n## License\n\nMIT -- see [`LICENSE`](LICENSE).\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**The sky is the limit.** Start automating.\n\n```bash\nnpm install -g jazz-ai \u0026\u0026 jazz\n```\n\n[Back to top](#jazz)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flvndry%2Fjazz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flvndry%2Fjazz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flvndry%2Fjazz/lists"}