{"id":44228569,"url":"https://github.com/warpdotdev/oz-agent-action","last_synced_at":"2026-06-03T03:05:28.438Z","repository":{"id":337548386,"uuid":"1154100514","full_name":"warpdotdev/oz-agent-action","owner":"warpdotdev","description":"Use the Oz coding agent in GitHub Actions","archived":false,"fork":false,"pushed_at":"2026-02-24T21:24:52.000Z","size":1496,"stargazers_count":33,"open_issues_count":3,"forks_count":14,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-25T01:50:02.795Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/warpdotdev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"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}},"created_at":"2026-02-10T02:31:09.000Z","updated_at":"2026-02-24T23:21:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/warpdotdev/oz-agent-action","commit_stats":null,"previous_names":["warpdotdev/oz-agent-action"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/warpdotdev/oz-agent-action","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/warpdotdev%2Foz-agent-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/warpdotdev%2Foz-agent-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/warpdotdev%2Foz-agent-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/warpdotdev%2Foz-agent-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/warpdotdev","download_url":"https://codeload.github.com/warpdotdev/oz-agent-action/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/warpdotdev%2Foz-agent-action/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29842961,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-25T21:18:31.832Z","status":"ssl_error","status_checked_at":"2026-02-25T21:18:29.265Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":[],"created_at":"2026-02-10T06:03:09.533Z","updated_at":"2026-06-03T03:05:28.431Z","avatar_url":"https://github.com/warpdotdev.png","language":"JavaScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"# Oz Agent Action\n\nThis action supports running the Oz Agent in GitHub Actions. It wraps the\n[Oz CLI](https://docs.warp.dev/developers/cli) with:\n\n- Caching for package installation\n- Capturing output for subsequent steps\n\n## Quickstart\n\nTo get started, you'll need a\n[Oz API Key](https://docs.warp.dev/developers/cli#api-key-authentication). We recommend storing this\nkey as a [secret](https://docs.github.com/en/actions/concepts/security/secrets) in your repository\nor organization.\n\nThen, add a step to your workflow that runs Oz:\n\n```yaml\n- name: Review code changes in Oz\n  uses: warpdotdev/oz-agent-action@v1\n  with:\n    prompt: |\n      Review the code changes on this branch:\n      1. Use the `git` command to identify changes from the base branch\n      2. Thoroughly analyze all changes, and identify any issues with style, security, or correctness\n      3. If you have suggestions, use the `gh` command to comment on the PR.\n    # Optional:\n    # model: \u003cwarp-model-id\u003e\n    # name: \"PR review\"\n    # mcp: |\n    #   {\"mcpServers\": {\"github\": {\"command\": \"npx\", \"args\": [\"-y\", \"@modelcontextprotocol/server-github\"], \"env\": {\"GITHUB_TOKEN\": \"${{ secrets.GITHUB_TOKEN }}\"}}}}\n    warp_api_key: ${{ secrets.WARP_API_KEY }}\n```\n\n## Using Skills\n\nSkills provide reusable, specialized capabilities for the Oz Agent. You can find a curated set of\nskills in the [oz-skills](https://github.com/warpdotdev/oz-skills) repository, or create your own.\n\nYou can use skills instead of or along with prompts:\n\n```yaml\n- name: Run agent with a skill\n  uses: warpdotdev/oz-agent-action@v1\n  with:\n    skill: 'my-skill'\n    warp_api_key: ${{ secrets.WARP_API_KEY }}\n```\n\nSkill format options:\n\n- `skill_name` - Searches for the skill in your repository's skill directories\n- `repo:skill_name` - Uses a skill from a specific repository\n- `org/repo:skill_name` - Uses a skill from a specific organization's repository\n\nYou can combine skills with prompts - the skill provides the base context and the prompt specifies\nthe task:\n\n```yaml\nwith:\n  skill: 'code-review'\n  prompt: 'Focus on security vulnerabilities in authentication code'\n  warp_api_key: ${{ secrets.WARP_API_KEY }}\n```\n\n## Helpful Tips\n\n- Inject relevant context from the GitHub event and previous steps into your Oz prompt via\n  templating.\n- Oz's output is available as `steps.${step_id}.outputs.agent_output`. Use the `output_format: json`\n  option to get machine-readable agent output!\n- For debugging, use the `share` option to automatically share the agent's session with your\n  teammates. See the\n  [Session Sharing](https://docs.warp.dev/knowledge-and-collaboration/session-sharing) documentation\n  for more info.\n\nSee the [action definition](./action.yml) for all options.\n\n## Example Workflows\n\nThis repository includes several example workflows in `examples/` that demonstrate how to use the Oz\nAgent Action for common development tasks.\n\nEach scenario is provided in three forms:\n\n- A **full reference workflow** in `examples/` that shows all jobs, permissions, and steps.\n- A **reusable workflow** in `.github/workflows/` that can be invoked via `workflow_call` from other\n  workflows.\n- A **lightweight consumer template** in `consumer-workflows/` that wires the appropriate triggers\n  and calls the reusable workflow via `jobs.\u003cid\u003e.uses`. These templates are intended to be copied\n  into `.github/workflows/` in your own repository and customized.\n\n### How to use the scenario workflows\n\n1. Pick a scenario below (e.g., Respond to Comment, Auto Fix Issue).\n2. Copy the corresponding file from `consumer-workflows/` into `.github/workflows/` in your\n   repository.\n3. Ensure the required secrets (such as `WARP_API_KEY`, and `SLACK_WEBHOOK_URL` where applicable)\n   are defined in your repository and mapped under the `secrets:` block.\n\nAlternatively, advanced users can call the reusable workflows directly from their own workflows via\n`jobs.\u003cid\u003e.uses` and wire `with:` and `secrets:` manually.\n\n### Respond to Comment\n\n_Full Example_: [examples/respond-to-comment.yml](examples/respond-to-comment.yml)\n\n_Consumer Template_:\n[consumer-workflows/respond-to-comment.yml](consumer-workflows/respond-to-comment.yml)\n\n**Usage:** Comment on a PR or Issue with `@oz-agent` (or your configured trigger phrase).\n\n**Description:** Allows you to interact with the Agent directly in comments (e.g., \"@oz-agent fix\nthis typo\").\n\n**Setup:**\n\n- Ensure `WARP_API_KEY` is set in Repository Secrets.\n\n**Expected Output:**\n\n- The Agent replies to your comment with an answer or confirmation.\n- If code changes were requested, the Agent commits them directly to the PR branch.\n\n**When to use:** Interactive coding assistance during code review or issue triage.\n\n### Auto PR Review\n\n_Full Example_: [examples/review-pr.yml](examples/review-pr.yml)\n\n_Consumer Template_: [consumer-workflows/review-pr.yml](consumer-workflows/review-pr.yml)\n\n**Usage:** Runs automatically when a Pull Request first becomes reviewable: either a non-draft Pull\nRequest is opened, or an existing draft Pull Request is marked ready for review. Comment\n`/oz-review` on the Pull Request to request another review.\n\n**Description:** Analyzes the PR diff and provides code review feedback. Each re-review focuses on\nchanges since the previous review.\n\n**Setup:**\n\n- Ensure `WARP_API_KEY` is set in Repository Secrets.\n- The Agent needs read access to contents and write access to pull-requests.\n\n**Expected Output:**\n\n- Inline comments on the PR diff highlighting potential bugs, security issues, or style\n  improvements.\n- A general summary comment if applicable.\n\n**When to use:** Get immediate feedback on code changes before human review, then run `/oz-review`\nagain after addressing feedback or adding commits.\n\n### Auto Fix Issue\n\n_Full Example_: [examples/auto-fix-issue.yml](examples/auto-fix-issue.yml)\n\n_Consumer Template_: [consumer-workflows/auto-fix-issue.yml](consumer-workflows/auto-fix-issue.yml)\n\n**Usage:** Apply the label `oz-agent` to any GitHub Issue.\n\n**Description:** Triggers when the label is applied, analyzes the issue, and attempts to write code\nto fix it.\n\n**Setup:**\n\n- Ensure `WARP_API_KEY` is set in Repository Secrets.\n- Action requires write permissions for contents, issues, and pull-requests.\n\n**Expected Output:**\n\n- If a fix is found: A new Pull Request (`fix/issue-NUMBER`) is created and linked to the issue.\n- If no fix is found: The Agent comments on the issue explaining why.\n\n**When to use:** Delegate bug fixes, small features, or chore tasks to the Oz Agent.\n\n### Daily Issue Summary\n\n_Full Example_: [examples/daily-issue-summary.yml](examples/daily-issue-summary.yml)\n\n_Consumer Template_:\n[consumer-workflows/daily-issue-summary.yml](consumer-workflows/daily-issue-summary.yml)\n\n**Usage:** Runs automatically on a schedule (every day at 9:00 UTC).\n\n**Description:** Fetches issues created in the last 24 hours and generates a summary.\n\n**Setup:**\n\n- Ensure `WARP_API_KEY` is set in Repository Secrets.\n- Ensure `SLACK_WEBHOOK_URL` is set in Repository Secrets to receive the report.\n\n**Expected Output:** A Slack message containing a categorized summary of new issues (Bugs, Features,\netc.).\n\n**When to use:** Keep your team aligned on incoming issues without manually checking GitHub.\n\n### Fix Failing Checks\n\n_Full Example_: [examples/fix-failing-checks.yml](examples/fix-failing-checks.yml)\n\n_Consumer Template_:\n[consumer-workflows/fix-failing-checks.yml](consumer-workflows/fix-failing-checks.yml)\n\n**Usage:** Triggers automatically when a specified workflow (e.g., \"Continuous Integration\") fails.\n\n**Description:** Analyzes failure logs from the failed workflow to determine the cause and attempts\na fix.\n\n**Setup:**\n\n- Ensure `WARP_API_KEY` is set in Repository Secrets.\n- Update the `workflow_run.workflows` list in the file to match your CI workflow names.\n\n**Expected Output:**\n\n- A new Pull Request containing the fix for the build or test failure.\n- Comments on the original PR (if applicable) with a link to the fix.\n\n**When to use:** Reduce downtime caused by broken builds or flaky tests.\n\n### Suggest Review Fixes\n\n_Full Example_: [examples/suggest-review-fixes.yml](examples/suggest-review-fixes.yml)\n\n_Consumer Template_:\n[consumer-workflows/suggest-review-fixes.yml](consumer-workflows/suggest-review-fixes.yml)\n\n**Usage:** Runs automatically when a Pull Request review is submitted.\n\n**Description:** Analyzes review comments. If a comment requests a simple fix (e.g., typo, naming,\nstyle), the Agent replies with a code suggestion block containing the fix.\n\n**Setup:**\n\n- Ensure `WARP_API_KEY` is set in Repository Secrets.\n- Action requires write permissions for `contents` and `pull-requests`.\n\n**Expected Output:**\n\n- Replies to review comments with code suggestions for simple fixes.\n- Skips complex or unclear comments.\n\n**When to use:** Speed up the cycle of applying review feedback for trivial issues.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwarpdotdev%2Foz-agent-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwarpdotdev%2Foz-agent-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwarpdotdev%2Foz-agent-action/lists"}