ona-dev-environment

ona-dev-environment

A Cowork plugin for managing Ona (formerly Gitpod) cloud dev environments from natural-language prompts inside the Cowork desktop app, using a Personal Access Token (PAT).

What it does

Lets you spin up, manage, and connect to remote containerized dev environments on Ona by talking to Claude in Cowork. Each environment is a devcontainer.json-defined workspace that boots from a Git repository URL and is reachable via VS Code in the browser, SSH, or any local IDE.

Prompts that activate the skill:

• "Spin up an Ona environment from https://github.com/owner/repo"
• "List my Ona environments"
• "Stop any Ona environment idle more than 24 hours, dry-run first"
• "Trigger an Ona prebuild for project <id> on machine class <id>"
• "Verify my Ona PAT"

Components

Type	Name	What it does
Skill	ona-dev-environment	Single comprehensive skill: full Ona API client, 12 task scripts, two reference docs, two examples, idle-env cleanup script

The skill ships 14 pure-Python scripts (no pip install required) covering: identity verification, machine-class listing, environment create (from repo URL or Project), get/list/start/stop/delete, project listing, prebuild create/list, and idle-env cleanup with dry-run support.

Installation

Recommended: install via Cowork plugin manager

If you have this published as a GitHub repo, install with Cowork's plugin manager UI or via Claude prompt:

"Install the plugin at https://github.com/<owner>/<repo>"

Manual install (until you have a GitHub repo)

1. Set your PAT once in PowerShell:

   setx ONA_TOKEN "<paste-from-https://app.ona.com/settings/personal-access-tokens>"
   

   Then close and reopen the shell so the env var propagates.

2. Run the local installer that places the plugin into Cowork's persistent plugin directory:

   & "C:\Users\jswil\.cursor\index\ona-dev-environment-plugin\install-local.ps1"
   

3. Close and reopen the Cowork desktop app so the plugin is discovered.

Authentication

The skill reads ONA_TOKEN from the user environment. Get a Read & Write PAT at https://app.ona.com/settings/personal-access-tokens. Treat it as a password — never commit it, never paste it into chat. Audit logs at https://app.ona.com track every API call by token ID.

Layout

ona-dev-environment/
├── .claude-plugin/
│   ├── plugin.json            # plugin manifest (name, version, author, license)
│   └── marketplace.json       # marketplace manifest for direct GitHub install
├── skills/
│   └── ona-dev-environment/
│       ├── SKILL.md           # core skill instructions and trigger description
│       ├── scripts/           # 14 stdlib-only Python scripts
│       ├── references/        # API reference + PAT setup walkthrough
│       └── examples/          # end-to-end annotated runs
├── README.md                  # this file
├── LICENSE                    # MIT
├── install-local.ps1          # manual install helper for non-GitHub flow
└── .gitignore

License

MIT. See LICENSE.

Links

• Ona API reference: https://ona.com/docs/api-reference
• Ona Personal access tokens: https://ona.com/docs/ona/integrations/personal-access-token