# oz-platform

oz-platform is a Claude Code skill for running and inspecting Oz cloud agents through Warp's REST API and CLI. It also handles schedules and agent environments.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 720 repo stars
- Author: dominikmartn
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dominikmartn/harp/tree/HEAD/resources/bundled/skills/oz-platform/SKILL.md
- Updated: 2026-11-10
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/oz-platform

## What it does

oz-platform lets an agent start Oz cloud runs, inspect their status, and work with the environments used by those runs. The CLI workflow covers prompts, models, environments, recurring schedules, and secrets.

The skill also describes the REST API plus TypeScript and Python SDK options, along with GitHub Actions integration for issue, pull request, push, and CI events. REST calls require a Warp API key, while CLI commands use `{{warp_cli_binary_name}}`. API requests fail without authentication.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill oz-platform -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/oz-platform/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/oz-platform/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill oz-platform -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/oz-platform/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill oz-platform -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/oz-platform/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dominikmartn/harp resources/bundled/skills/oz-platform
```

2. **Manually: put the files in place**
- File: `.github/skills/oz-platform/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill oz-platform -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/dominikmartn/harp --path resources/bundled/skills/oz-platform
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/oz-platform/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/dominikmartn/harp/tree/HEAD/resources/bundled/skills/oz-platform/SKILL.md

## When to use it
- launch an Oz cloud agent with a prompt and environment
- inspect the status and details of a cloud run
- schedule an agent to repeat work on a cron expression
- create environments and secrets for cloud agents
- trigger an agent from GitHub Actions events

## Example prompts
- Start an Oz cloud agent with the prompt “Make the login error more specific” in environment `UA17BXYZ` using `{{warp_cli_binary_name}}`.
- Create a daily 8:00 UTC schedule that summarizes new GitHub issue feedback with `{{warp_cli_binary_name}} schedule create`.
- Set up a GitHub Actions workflow that asks the agent to analyze new issues and post a summary with `gh`.

## Similar
- [platform-sandbox-configure](https://affpapa.org/en/nevibecode/skills/platform-sandbox-configure.md) — skill · 3200 installs
- [warp-delegate](https://affpapa.org/en/nevibecode/skills/warp-delegate.md) — skill · 3100 installs
- [recoup-platform-api-access](https://affpapa.org/en/nevibecode/skills/recoup-platform-api-access.md) — skill · 5500 installs
- [llmops-platform-engineering](https://affpapa.org/en/nevibecode/skills/llmops-platform-engineering.md) — skill · 350 installs
- [managed-agent](https://affpapa.org/en/nevibecode/skills/managed-agent.md) — skill · 597 installs
- [orchestrate](https://affpapa.org/en/nevibecode/skills/orchestrate.md) — skill · 1300 installs

From the same set: [dominikmartn/harp](https://affpapa.org/en/nevibecode/by/dominikmartn/harp.md) — 62 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
