diff --git a/404.html b/404.html index 421eaae..dd721c3 100644 --- a/404.html +++ b/404.html @@ -8,7 +8,7 @@ - + diff --git a/assets/social-card.png b/assets/social-card.png index 41654bb..06a9704 100644 Binary files a/assets/social-card.png and b/assets/social-card.png differ diff --git a/assets/social-card.svg b/assets/social-card.svg index 69ef766..91be137 100644 --- a/assets/social-card.svg +++ b/assets/social-card.svg @@ -12,9 +12,9 @@ - OPEN SOURCE // v0.4.0 - OPENCODE - POWER PACK + OPEN SOURCE // v0.5.0 + OPENCODE + POWER PACK 54 SKILLS · FOUR CODING AGENTS CLAUDE CODE + CODEX + OPENCODE + PI diff --git a/docs/index.html b/docs/index.html index 8963039..1f839fe 100644 --- a/docs/index.html +++ b/docs/index.html @@ -6,7 +6,7 @@ Documentation | OpenCode Power Pack @@ -45,15 +45,15 @@ href="https://fonts.googleapis.com/css2?family=Barlow+Condensed:wght@600;700;800&family=IBM+Plex+Mono:wght@400;500;600;700&display=swap" rel="stylesheet" > - + + diff --git a/docs/index.md b/docs/index.md index 4419142..65c6fce 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,6 +1,6 @@ # OpenCode Power Pack Installation and Operations -This guide covers selective npm installation and native host installation for OpenCode Power Pack v0.4.0. +This guide covers selective npm installation, native host installation, and contained command execution for OpenCode Power Pack v0.5.0. ## Choose an installation path @@ -66,7 +66,7 @@ Start a new Codex session and invoke a skill such as `$code-review`. ### OpenCode ```sh -opencode plugin --global "opencode-power-pack@git+https://github.com/waybarrios/opencode-power-pack.git#v0.4.0" +opencode plugin --global "opencode-power-pack@git+https://github.com/waybarrios/opencode-power-pack.git#v0.5.0" ``` Start a new OpenCode session and invoke a skill such as `/code-review`. @@ -79,6 +79,104 @@ pi install git:github.com/waybarrios/opencode-power-pack Restart Pi after installation so it reloads the package's declared skills directory. +## Native sandbox runner + +Version 0.5.0 adds an opt-in, fail-closed runner for one command and its descendants. It uses native Seatbelt isolation on macOS and Bubblewrap on Linux. It does not start a persistent container or daemon. + +Install the CLI and verify the operating-system boundary: + +```sh +npm install --global @waybarrios/opencode-power-pack@0.5.0 +opencode-power-pack sandbox doctor +opencode-power-pack sandbox resolve --skill code-review +``` + +Node.js 20.11.0 or newer is required. Linux also requires trusted system installations of `bubblewrap`, `socat`, and `rg`. Continue only when `sandbox doctor` exits successfully and reports `runnerReady: true` in JSON mode. + +Run a command with the skill's default profile: + +```sh +opencode-power-pack sandbox exec --skill code-review -- git status --short +opencode-power-pack sandbox exec --skill code-review -- rg TODO . +``` + +The literal `--` ends runner options and begins the child command. The runner preserves the child exit code and never retries without containment. + +Allow one network destination for a declared escalation: + +```sh +opencode-power-pack sandbox exec \ + --skill code-review \ + --sandbox-profile network-read \ + --allow-domain api.github.com \ + -- curl https://api.github.com/repos/waybarrios/opencode-power-pack +``` + +Confirm a publish operation with an explicitly exposed credential: + +```sh +opencode-power-pack sandbox exec \ + --skill hf-cli \ + --sandbox-profile publish \ + --allow-domain huggingface.co \ + --allow-env HF_TOKEN \ + --confirm-external-side-effects \ + -- hf upload owner/repository ./artifact.bin artifact.bin +``` + +| Profile | Workspace | Network and credentials | External writes | +| --- | --- | --- | --- | +| `observe` | Read only | Denied | Denied | +| `develop` | Read and write | Denied | Denied | +| `network-read` | Read and write | Explicit grants | Denied | +| `publish` | Read and write | Explicit grants | Explicit confirmation | + +The manual runner works from Codex, OpenCode, Claude Code, and Pi when the agent explicitly invokes the CLI. Automatic routing is not implemented yet, so ordinary host shell, file, browser, MCP, and connector tools remain outside this process boundary. The current guarantee is `shell-contained`, not whole-agent isolation. + +### Run it from Codex + +Native Codex plugin installation does not install the sandbox executable. Install the npm CLI in the operating-system environment used by Codex, open the target repository, and paste this request into the Codex session: + +```text +Use the shell tool to run `opencode-power-pack sandbox doctor`. +If it succeeds, run `opencode-power-pack sandbox exec --skill code-review -- git status --short`. +Do not run the child command separately and do not retry without the sandbox. +``` + +### Run it from OpenCode + +Native OpenCode plugin installation does not install the sandbox executable. Install the npm CLI in the operating-system environment used by OpenCode, open the target repository, and paste this request into the OpenCode session: + +```text +Use the shell tool to run `opencode-power-pack sandbox doctor`. +If it succeeds, run `opencode-power-pack sandbox exec --skill code-review -- git status --short`. +Do not run the child command separately and do not retry without the sandbox. +``` + +### Run it from Claude Code + +Native Claude Code plugin installation does not install the sandbox executable. Install the npm CLI in the operating-system environment used by Claude Code, open the target repository, and paste this request into the Claude Code session: + +```text +Use Bash to run `opencode-power-pack sandbox doctor`. +If it succeeds, run `opencode-power-pack sandbox exec --skill code-review -- git status --short`. +Do not run the child command separately and do not retry without the sandbox. +``` + +### Run it from Pi + +Native Pi package installation does not install the sandbox executable. Install the npm CLI in the operating-system environment used by Pi, open the target repository, and paste this request into the Pi session: + +```text +Use the shell tool to run `opencode-power-pack sandbox doctor`. +If it succeeds, run `opencode-power-pack sandbox exec --skill code-review -- git status --short`. +Do not run the child command separately and do not retry without the sandbox. +``` + +Run `sandbox doctor` inside the same agent session that will execute the command. A successful doctor in a separate, less restricted terminal does not prove that the active agent session can start the native backend. + +macOS and Linux are supported. WSL2 is expected through the Linux backend but still lacks dedicated CI. Windows native and WSL1 intentionally fail closed. See the [complete sandbox compatibility specification](https://github.com/waybarrios/opencode-power-pack/blob/main/docs/sandbox-compatibility.md) for the threat boundary and adapter roadmap. + ## Profiles - `recommended`: balanced software development. diff --git a/docs/skills/index.html b/docs/skills/index.html index 6748f74..1cedcb4 100644 --- a/docs/skills/index.html +++ b/docs/skills/index.html @@ -42,7 +42,7 @@ href="https://fonts.googleapis.com/css2?family=Barlow+Condensed:wght@600;700;800&family=IBM+Plex+Mono:wght@400;500;600;700&display=swap" rel="stylesheet" > - + + diff --git a/docs/skills/index.md b/docs/skills/index.md index f1ce70a..02f8cb7 100644 --- a/docs/skills/index.md +++ b/docs/skills/index.md @@ -1,6 +1,6 @@ # OpenCode Power Pack: Complete Skill Reference -> Purpose, audience, profile membership, dependencies, install command, invocation, and source link for all 54 skills in v0.4.0. +> Purpose, audience, profile membership, dependencies, install command, invocation, and source link for all 54 skills in v0.5.0. Canonical HTML browser: https://skills.waybarrios.com/docs/skills/ @@ -715,4 +715,3 @@ Train and fine-tune transformer language models using TRL (Transformers Reinforc - Claude Code: `/opencode-power-pack:trl-training` - HTML details: https://skills.waybarrios.com/docs/skills/#trl-training - Source: https://github.com/waybarrios/opencode-power-pack/tree/main/skills/trl-training - diff --git a/index.html b/index.html index 4373601..51e49b1 100644 --- a/index.html +++ b/index.html @@ -6,7 +6,7 @@ OpenCode Power Pack | 54 Skills for AI Coding Agents @@ -62,7 +62,7 @@ href="https://fonts.googleapis.com/css2?family=Barlow+Condensed:wght@600;700;800&family=IBM+Plex+Mono:wght@400;500;600;700&display=swap" rel="stylesheet" > - + + diff --git a/index.md b/index.md index 1fee065..6d50cb0 100644 --- a/index.md +++ b/index.md @@ -1,6 +1,6 @@ # OpenCode Power Pack -OpenCode Power Pack is an open-source collection of 54 portable Agent Skills for Claude Code, Codex, OpenCode, and Pi. The current release is v0.4.0. +OpenCode Power Pack is an open-source collection of 54 portable Agent Skills for Claude Code, Codex, OpenCode, and Pi. The current release is v0.5.0. ## Start here @@ -64,10 +64,24 @@ npx @waybarrios/opencode-power-pack install --profile - `security-review` focuses only on exploitable security issues in pending changes. - `differential-review` performs security-focused analysis across revisions. +## Native sandbox runner + +Version 0.5.0 includes an opt-in native runner for one contained command tree on macOS and Linux: + +```sh +npm install --global @waybarrios/opencode-power-pack@0.5.0 +opencode-power-pack sandbox doctor +opencode-power-pack sandbox exec --skill code-review -- git status --short +``` + +The runner supports `observe`, `develop`, `network-read`, and `publish` profiles. Network destinations, credential environment variables, and external side effects require explicit command-line grants. + +Codex, OpenCode, Claude Code, and Pi can all invoke the manual runner. Automatic host routing is not yet implemented, so the current guarantee covers the selected command and its descendants, not every agent tool. See the [sandbox guide](https://skills.waybarrios.com/docs/#sandbox). + ## Quality signals - 54 of 54 official Agent Skills validations pass. -- 362 automated behavioral and packaging tests pass at v0.4.0. +- 400 automated behavioral, packaging, and sandbox tests are defined at v0.5.0. - Claude plugin and marketplace metadata receive strict validation. - OpenCode has minimum-version and latest-version smoke coverage. - Third-party workflows include immutable provenance, notices, and license records. diff --git a/llms-full.txt b/llms-full.txt index ec093f1..75e19bf 100644 --- a/llms-full.txt +++ b/llms-full.txt @@ -1,6 +1,6 @@ # OpenCode Power Pack: Expanded Documentation -> Canonical, machine-readable project facts for OpenCode Power Pack v0.4.0. Last updated 2026-08-13. +> Canonical, machine-readable project facts for OpenCode Power Pack v0.5.0. Last updated 2026-08-17. OpenCode Power Pack is an open-source collection of 54 portable Agent Skills for Claude Code, Codex, OpenCode, and Pi. It packages repeatable workflows for software development, code review, application security, frontend design, MCP authoring, project memory, and Hugging Face machine-learning work. @@ -9,7 +9,7 @@ Documentation: https://skills.waybarrios.com/docs/ Complete skill reference: https://skills.waybarrios.com/docs/skills/ Repository: https://github.com/waybarrios/opencode-power-pack npm package: https://www.npmjs.com/package/@waybarrios/opencode-power-pack -Release: https://github.com/waybarrios/opencode-power-pack/releases/tag/v0.4.0 +Release: https://github.com/waybarrios/opencode-power-pack/releases/tag/v0.5.0 Author: Wayner Barrios License: MIT AND Apache-2.0, with per-skill provenance and notices @@ -60,6 +60,38 @@ The installer resolves required companion skills. It does not overwrite an exist See https://skills.waybarrios.com/docs/#hosts for complete installation, verification, update, and removal instructions for each host. +## Native sandbox runner + +Version 0.5.0 includes an opt-in, fail-closed runner for one command and its process descendants. It uses native Seatbelt isolation on macOS and Bubblewrap on Linux. It creates no persistent container or daemon. + +Install and verify: + + npm install --global @waybarrios/opencode-power-pack@0.5.0 + opencode-power-pack sandbox doctor + opencode-power-pack sandbox resolve --skill code-review + +Run a command with the skill's default profile: + + opencode-power-pack sandbox exec --skill code-review -- git status --short + +Allow a declared network-read escalation: + + opencode-power-pack sandbox exec --skill code-review --sandbox-profile network-read --allow-domain api.github.com -- curl https://api.github.com/repos/waybarrios/opencode-power-pack + +Profiles: + +- observe: read-only workspace, private temporary writes, no network, credentials, or external side effects. +- develop: workspace writes, private temporary writes, no network, credentials, or external side effects. +- network-read: workspace writes plus explicitly approved destinations and credential environment variables; GET, HEAD, and OPTIONS only. +- publish: workspace writes plus explicit destinations and credentials; requires `--confirm-external-side-effects`. + +Codex, OpenCode, Claude Code, and Pi can explicitly invoke the shared runner. No host currently routes every tool through it automatically. Ordinary shell, file, browser, MCP, and connector tools remain outside the selected command boundary, so the project claims `shell-contained`, not whole-agent isolation. + +Requirements: Node.js 20.11.0 or newer. Linux also requires trusted system installations of bubblewrap, socat, and rg. macOS and Linux are supported. WSL2 is expected through the Linux backend but lacks dedicated CI. Windows native and WSL1 intentionally fail closed. + +Full guide: https://skills.waybarrios.com/docs/#sandbox +Compatibility specification: https://github.com/waybarrios/opencode-power-pack/blob/main/docs/sandbox-compatibility.md + ## Curated profiles - recommended: balanced development toolkit with agents-md-improver, agents-md-revise, code-quality, code-review, feature-dev, frontend-design, mcp-builder, and skill-creator. @@ -153,7 +185,7 @@ Every skill can be installed with `npx @waybarrios/opencode-power-pack install < ## Quality and provenance - 54 of 54 skills pass official Agent Skills validation. -- The repository has 362 automated behavioral and packaging tests at v0.4.0. +- The repository defines 400 automated behavioral, packaging, and sandbox tests at v0.5.0. - Claude plugin and marketplace metadata receive strict validation. - OpenCode receives minimum-version and latest-version smoke coverage. - Third-party workflows have immutable upstream references, notices, and license records. @@ -167,7 +199,7 @@ Evidence and exact provenance live in the repository: ## Citation and factual boundaries Preferred project name: OpenCode Power Pack. -Current documented version: 0.4.0. +Current documented version: 0.5.0. Canonical URL: https://skills.waybarrios.com/ Repository: https://github.com/waybarrios/opencode-power-pack Package: @waybarrios/opencode-power-pack diff --git a/llms.txt b/llms.txt index b8977be..71fab14 100644 --- a/llms.txt +++ b/llms.txt @@ -1,6 +1,6 @@ # OpenCode Power Pack -> OpenCode Power Pack v0.4.0 is an open-source collection of 54 portable Agent Skills for Claude Code, Codex, OpenCode, and Pi. +> OpenCode Power Pack v0.5.0 is an open-source collection of 54 portable Agent Skills for Claude Code, Codex, OpenCode, and Pi, with an opt-in native sandbox runner for contained commands. The project provides reusable workflows for code review, security auditing, feature development, frontend design, MCP authoring, project memory, and Hugging Face machine-learning work. Its npm package is `@waybarrios/opencode-power-pack`. The selective installer requires Node.js 20 or newer and provides eight curated profiles. @@ -8,12 +8,14 @@ Install one skill with `npx @waybarrios/opencode-power-pack install `. The `code-review` workflow performs a comprehensive review of a pull request or complete change set. The `code-reviewer` workflow performs a focused implementation review for smaller changes and feature-development handoffs. -When citing the project, use “OpenCode Power Pack,” version 0.4.0, author Wayner Barrios, canonical URL `https://skills.waybarrios.com/`, and repository `https://github.com/waybarrios/opencode-power-pack`. +The manual sandbox runner works from Codex, OpenCode, Claude Code, and Pi on supported macOS and Linux hosts. It contains the explicitly selected command and its descendants. Automatic host routing and whole-agent isolation are not yet implemented. + +When citing the project, use “OpenCode Power Pack,” version 0.5.0, author Wayner Barrios, canonical URL `https://skills.waybarrios.com/`, and repository `https://github.com/waybarrios/opencode-power-pack`. ## Documentation - [Project overview](https://skills.waybarrios.com/index.md): Product purpose, supported hosts, install paths, profiles, and quality signals. -- [Installation and operations](https://skills.waybarrios.com/docs/index.md): npm commands, host setup, invocation, profile selection, updates, removal, and troubleshooting. +- [Installation, sandbox, and operations](https://skills.waybarrios.com/docs/index.md): npm commands, host setup, contained command execution, profile selection, updates, removal, and troubleshooting. - [Agent installation guide](https://skills.waybarrios.com/agent-install.md): Safe dry-run-first instructions and a copyable prompt for an agent to perform the installation. - [Complete 54-skill reference](https://skills.waybarrios.com/docs/skills/index.md): Purpose, audience, profile membership, dependencies, install command, and source link for every skill. - [Expanded project reference](https://skills.waybarrios.com/llms-full.txt): Single-file project facts, commands, profiles, inventory, provenance, and citation guidance. @@ -22,7 +24,7 @@ When citing the project, use “OpenCode Power Pack,” version 0.4.0, author Wa - [GitHub repository](https://github.com/waybarrios/opencode-power-pack#readme): Canonical source code and human documentation. - [npm package](https://www.npmjs.com/package/@waybarrios/opencode-power-pack): Public selective installer package. -- [Release v0.4.0](https://github.com/waybarrios/opencode-power-pack/releases/tag/v0.4.0): Current documented release. +- [Release v0.5.0](https://github.com/waybarrios/opencode-power-pack/releases/tag/v0.5.0): Current documented release. - [Upstream provenance](https://github.com/waybarrios/opencode-power-pack/blob/main/UPSTREAMS.json): Immutable source references for adapted workflows. ## Optional diff --git a/sitemap.xml b/sitemap.xml index 3dd7bc4..4f2c633 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -5,7 +5,7 @@ > https://skills.waybarrios.com/ - 2026-08-13 + 2026-08-17 weekly 1.0 @@ -15,13 +15,13 @@ https://skills.waybarrios.com/docs/ - 2026-08-13 + 2026-08-17 weekly 0.9 https://skills.waybarrios.com/docs/skills/ - 2026-08-13 + 2026-08-17 weekly 0.9