Publish the version 0.5.0 sandbox guide across the project website

Document installation, readiness checks, profile escalation, per-host usage for Codex, OpenCode, Claude Code, and Pi, supported platforms, and the shell-contained security boundary while refreshing release metadata and machine-readable references.
This commit is contained in:
Wayner Barrios
2026-08-17 14:19:15 -05:00
parent df01b438df
commit 194a977d5b
12 changed files with 365 additions and 45 deletions
+1 -1
View File
@@ -8,7 +8,7 @@
<meta name="robots" content="noindex, follow">
<meta name="theme-color" content="#0b0f14">
<link rel="icon" href="/assets/favicon.svg" type="image/svg+xml">
<link rel="stylesheet" href="/styles.css?v=0.4.0-responsive-prompt-1">
<link rel="stylesheet" href="/styles.css?v=0.5.0-sandbox-1">
</head>
<body>
<a class="skip-link" href="#main">Skip to content</a>
Binary file not shown.

Before

Width:  |  Height:  |  Size: 64 KiB

After

Width:  |  Height:  |  Size: 67 KiB

+3 -3
View File
@@ -12,9 +12,9 @@
<path d="M145 0 0 190h103L78 335l170-219H138z" fill="#ffd60a"/>
</g>
<g font-family="IBM Plex Mono,monospace">
<text x="390" y="150" fill="#9aa6b2" font-size="22" font-weight="700" letter-spacing="5">OPEN SOURCE // v0.4.0</text>
<text x="390" y="270" fill="#f1f0eb" font-family="Barlow Condensed,sans-serif" font-size="112" font-weight="800" letter-spacing="-2">OPENCODE</text>
<text x="390" y="370" fill="#ffd60a" font-family="Barlow Condensed,sans-serif" font-size="112" font-weight="800" letter-spacing="2">POWER PACK</text>
<text x="390" y="150" fill="#9aa6b2" font-size="22" font-weight="700" letter-spacing="5">OPEN SOURCE // v0.5.0</text>
<text x="390" y="270" fill="#f1f0eb" font-family="Barlow Condensed,sans-serif" font-size="94" font-weight="800" letter-spacing="-2">OPENCODE</text>
<text x="390" y="370" fill="#ffd60a" font-family="Barlow Condensed,sans-serif" font-size="86" font-weight="800" letter-spacing="2">POWER PACK</text>
<text x="390" y="440" fill="#f1f0eb" font-size="28" font-weight="600">54 SKILLS · FOUR CODING AGENTS</text>
<text x="390" y="492" fill="#9aa6b2" font-size="20">CLAUDE CODE + CODEX + OPENCODE + PI</text>
</g>

Before

Width:  |  Height:  |  Size: 1.7 KiB

After

Width:  |  Height:  |  Size: 1.7 KiB

+168 -12
View File
@@ -6,7 +6,7 @@
<title>Documentation | OpenCode Power Pack</title>
<meta
name="description"
content="Install and use OpenCode Power Pack Agent Skills with Claude Code, Codex, OpenCode, and Pi. npm profiles, host setup, skill selection, updates, and troubleshooting."
content="Install and use OpenCode Power Pack Agent Skills and its opt-in native sandbox runner with Claude Code, Codex, OpenCode, and Pi."
>
<meta name="robots" content="index, follow, max-snippet:-1">
<meta name="theme-color" content="#0b0f14">
@@ -45,15 +45,15 @@
href="https://fonts.googleapis.com/css2?family=Barlow+Condensed:wght@600;700;800&amp;family=IBM+Plex+Mono:wght@400;500;600;700&amp;display=swap"
rel="stylesheet"
>
<link rel="stylesheet" href="../styles.css?v=0.4.0-responsive-prompt-1">
<link rel="stylesheet" href="../styles.css?v=0.5.0-sandbox-1">
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "TechArticle",
"headline": "OpenCode Power Pack Documentation",
"description": "Installation and usage documentation for OpenCode Power Pack Agent Skills.",
"description": "Installation, usage, and native sandbox documentation for OpenCode Power Pack Agent Skills.",
"url": "https://skills.waybarrios.com/docs/",
"dateModified": "2026-08-13",
"dateModified": "2026-08-17",
"author": {
"@type": "Person",
"name": "Wayner Barrios",
@@ -87,9 +87,9 @@
<body class="docs-body">
<a class="skip-link" href="#docs-main">Skip to documentation</a>
<div class="status-rail" aria-hidden="true">
<span>DOCUMENTATION // v0.4.0</span>
<span>DOCUMENTATION // v0.5.0</span>
<span>54 MODULES</span>
<span>LAST UPDATED 2026-08-13</span>
<span>LAST UPDATED 2026-08-17</span>
</div>
<div class="docs-shell">
@@ -105,6 +105,7 @@
<a href="#npm">Selective npm</a>
<a href="#agent-install">Agent-assisted install</a>
<a href="#cli">CLI reference</a>
<a href="#sandbox">Sandbox runner</a>
<a href="#how-skills-work">How skills work</a>
<a href="#hosts">Full host installs</a>
<a href="#profiles">Profiles + contents</a>
@@ -127,8 +128,8 @@
<h1>Documentation</h1>
<p>
Start with the installation model, then choose a profile or individual workflow. This guide
explains destinations, dependency resolution, host activation, invocation, verification,
updates, removal, and the purpose of every bundled skill.
explains destinations, dependency resolution, host activation, contained command execution,
verification, updates, removal, and the purpose of every bundled skill.
</p>
</header>
@@ -368,6 +369,161 @@ opencode-power-pack list
opencode-power-pack install code-review</code></div>
</section>
<section class="docs-section" id="sandbox">
<h2>Run commands in the native sandbox</h2>
<p>
Version 0.5.0 adds an opt-in, fail-closed runner for one command and its complete process tree.
It uses native Seatbelt isolation on macOS and Bubblewrap on Linux. It starts no persistent
container or daemon, and it removes its private temporary directory after the command exits.
</p>
<h3>Install and check readiness</h3>
<p>
The sandbox runtime is part of the npm package. Node.js 20.11.0 or newer is required. Linux
also needs trusted system installations of <code>bubblewrap</code>, <code>socat</code>, and
<code>rg</code>. macOS uses the built-in Seatbelt backend.
</p>
<div class="docs-code"><code># Keep the v0.5.0 CLI available
npm install --global @waybarrios/opencode-power-pack@0.5.0
# Verify the actual operating-system boundary
opencode-power-pack sandbox doctor
# Inspect the policy assigned to one skill
opencode-power-pack sandbox resolve --skill code-review</code></div>
<p class="note">
Continue only when <code>sandbox doctor</code> exits successfully and reports
<code>runnerReady: true</code> in JSON mode. A failed doctor never authorizes an unsandboxed retry.
</p>
<h3>Run a contained command</h3>
<div class="docs-code"><code># code-review defaults to the read-only observe profile
opencode-power-pack sandbox exec --skill code-review -- git status --short
# The literal -- ends runner options and starts the child command
opencode-power-pack sandbox exec --skill code-review -- rg TODO .</code></div>
<p>
The runner resolves the trusted profile packaged for the selected skill. It preserves the child
exit code, hides unrelated host files and credentials, restricts workspace writes according to
the profile, and never falls back to ordinary execution when setup or cleanup fails.
</p>
<h3>Allow a narrow network read</h3>
<div class="docs-code"><code>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</code></div>
<p>
<code>network-read</code> permits only GET, HEAD, and OPTIONS through the filtered proxy. It is
a method-level best effort, because a poorly designed GET endpoint can still have side effects.
Approve the narrowest destination and expose no credential unless the retrieval requires it.
</p>
<h3>Confirm an external write</h3>
<div class="docs-code"><code>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</code></div>
<p>
A publish-capable skill still requires the exact domain, each credential environment variable,
and <code>--confirm-external-side-effects</code>. The runner rejects undeclared escalations.
</p>
<h3>Profiles</h3>
<section class="docs-table-wrap" aria-label="Sandbox profile capabilities" tabindex="0">
<table class="docs-table">
<thead><tr><th>Profile</th><th>Workspace</th><th>Network and credentials</th><th>External writes</th></tr></thead>
<tbody>
<tr><td><code>observe</code></td><td>Read only</td><td>Denied</td><td>Denied</td></tr>
<tr><td><code>develop</code></td><td>Read and write</td><td>Denied</td><td>Denied</td></tr>
<tr><td><code>network-read</code></td><td>Read and write</td><td>Explicit grants</td><td>Denied</td></tr>
<tr><td><code>publish</code></td><td>Read and write</td><td>Explicit grants</td><td>Explicit confirmation</td></tr>
</tbody>
</table>
</section>
<h3>Codex, OpenCode, Claude Code, and Pi compatibility</h3>
<section class="docs-table-wrap" aria-label="Sandbox coding-agent compatibility" tabindex="0">
<table class="docs-table">
<thead><tr><th>Host</th><th>Manual runner</th><th>Automatic routing</th><th>Current boundary</th></tr></thead>
<tbody>
<tr><td>Codex</td><td>Supported</td><td>Not yet implemented</td><td>Explicit sandbox CLI command and descendants</td></tr>
<tr><td>OpenCode</td><td>Supported</td><td>Not yet implemented</td><td>Explicit sandbox CLI command and descendants</td></tr>
<tr><td>Claude Code</td><td>Supported</td><td>Not yet implemented</td><td>Explicit sandbox CLI command and descendants</td></tr>
<tr><td>Pi</td><td>Supported</td><td>Not yet implemented</td><td>Explicit sandbox CLI command and descendants</td></tr>
</tbody>
</table>
</section>
<h3>Run it from each host</h3>
<p>
Native skill or plugin installation does not place the sandbox CLI on <code>PATH</code>. Install
the npm CLI once in the operating-system environment used by the agent, then run the doctor from
that same agent session. A doctor that succeeds in another terminal does not prove that a more
restricted agent session can start the backend.
</p>
<div class="docs-code"><code>npm install --global @waybarrios/opencode-power-pack@0.5.0</code></div>
<article class="host-doc">
<header><span>01</span><h3>Codex</h3><b>MANUAL RUNNER</b></header>
<p>Paste this request into Codex while the session is open in the target repository:</p>
<div class="docs-code"><code>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.</code></div>
<p>Codex invokes the shared CLI through its shell tool. Its other tools are not automatically routed through this runner.</p>
</article>
<article class="host-doc">
<header><span>02</span><h3>OpenCode</h3><b>MANUAL RUNNER</b></header>
<p>Paste this request into OpenCode while the session is open in the target repository:</p>
<div class="docs-code"><code>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.</code></div>
<p>OpenCode invokes the same CLI through its shell tool. A future custom-tool adapter is required for automatic enforcement.</p>
</article>
<article class="host-doc">
<header><span>03</span><h3>Claude Code</h3><b>MANUAL RUNNER</b></header>
<p>Paste this request into Claude Code while the session is open in the target repository:</p>
<div class="docs-code"><code>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.</code></div>
<p>Claude Code invokes the shared CLI through Bash. Read, Edit, Write, WebFetch, MCP, and computer-use tools remain separate host surfaces.</p>
</article>
<article class="host-doc">
<header><span>04</span><h3>Pi</h3><b>MANUAL RUNNER</b></header>
<p>Paste this request into Pi while the session is open in the target repository:</p>
<div class="docs-code"><code>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.</code></div>
<p>Pi invokes the shared CLI through its shell tool. A future extension must replace or intercept built-in tools for automatic enforcement.</p>
</article>
<p class="note">
Yes, it works from Codex and OpenCode when either agent explicitly invokes the CLI. A skill file
cannot silently change the host session's sandbox. Ordinary shell, file, browser, MCP, and connector
tools remain outside this command boundary until host-specific adapters block those bypass paths.
The project therefore claims <code>shell-contained</code>, not whole-agent isolation.
</p>
<h3>Platform status</h3>
<ul>
<li><strong>macOS:</strong> supported with the built-in Seatbelt backend.</li>
<li><strong>Linux:</strong> supported when Bubblewrap namespaces and the required trusted helpers are available.</li>
<li><strong>WSL2:</strong> expected to use the Linux backend, but dedicated CI is still pending.</li>
<li><strong>Windows native and WSL1:</strong> unsupported and intentionally fail closed.</li>
</ul>
<p>
For the complete threat boundary, Git worktree handling, network limitations, native dependency
checks, and adapter roadmap, read the
<a href="https://github.com/waybarrios/opencode-power-pack/blob/main/docs/sandbox-compatibility.md">sandbox compatibility specification</a>.
</p>
</section>
<section class="docs-section" id="how-skills-work">
<h2>How skills work</h2>
<p>
@@ -423,8 +579,8 @@ codex plugin list --marketplace opencode-power-pack</code></div>
<article class="host-doc" id="host-opencode">
<header><span>03</span><h3>OpenCode</h3><b>FULL CATALOG</b></header>
<p>OpenCode 1.18.7 or newer is required. Pin v0.4.0 for a reproducible installation.</p>
<div class="docs-code"><code>opencode plugin --global "opencode-power-pack@git+https://github.com/waybarrios/opencode-power-pack.git#v0.4.0"</code></div>
<p>OpenCode 1.18.7 or newer is required. Pin v0.5.0 for a reproducible installation.</p>
<div class="docs-code"><code>opencode plugin --global "opencode-power-pack@git+https://github.com/waybarrios/opencode-power-pack.git#v0.5.0"</code></div>
<dl>
<div><dt>Restart</dt><dd>Start a new OpenCode session after the command finishes.</dd></div>
<div><dt>Verify</dt><dd>Run <code>opencode debug skill</code>; it should list all 54 unprefixed IDs.</dd></div>
@@ -560,7 +716,7 @@ npx @waybarrios/opencode-power-pack@latest install --profile review --force
# Update one project-local skill
npx @waybarrios/opencode-power-pack@latest install code-review --project --force</code></div>
<p>
The selective CLI has no remove command in v0.4.0. To remove a copied workflow, verify the
The selective CLI has no remove command in v0.5.0. To remove a copied workflow, verify the
destination printed by the installer and delete only its exact skill directory, such as
<code>~/.agents/skills/code-review</code> or <code>&lt;repo&gt;/.agents/skills/code-review</code>.
</p>
@@ -631,6 +787,6 @@ pi remove git:github.com/waybarrios/opencode-power-pack</code></div>
</section>
</main>
</div>
<script src="../app.js?v=0.4.0-responsive-prompt-1" defer></script>
<script src="../app.js?v=0.5.0-sandbox-1" defer></script>
</body>
</html>
+100 -2
View File
@@ -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.
+3 -3
View File
@@ -42,7 +42,7 @@
href="https://fonts.googleapis.com/css2?family=Barlow+Condensed:wght@600;700;800&amp;family=IBM+Plex+Mono:wght@400;500;600;700&amp;display=swap"
rel="stylesheet"
>
<link rel="stylesheet" href="../../styles.css?v=0.4.0-responsive-prompt-1">
<link rel="stylesheet" href="../../styles.css?v=0.5.0-sandbox-1">
<script type="application/ld+json">
{
"@context": "https://schema.org",
@@ -468,7 +468,7 @@
<body class="docs-body">
<a class="skip-link" href="#skills-main">Skip to skill reference</a>
<div class="status-rail" aria-hidden="true">
<span>SKILL REFERENCE // v0.4.0</span>
<span>SKILL REFERENCE // v0.5.0</span>
<span>54 DOCUMENTED</span>
<span>INDIVIDUAL INSTALLS</span>
</div>
@@ -2377,6 +2377,6 @@ npx @waybarrios/opencode-power-pack install code-review</code></div>
</section>
</main>
</div>
<script src="../../app.js?v=0.4.0-responsive-prompt-1" defer></script>
<script src="../../app.js?v=0.5.0-sandbox-1" defer></script>
</body>
</html>
+1 -2
View File
@@ -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
+28 -9
View File
@@ -6,7 +6,7 @@
<title>OpenCode Power Pack | 54 Skills for AI Coding Agents</title>
<meta
name="description"
content="Install 54 production-grade Agent Skills for Claude Code, Codex, OpenCode, and Pi. Code review, security, feature development, frontend, MCP, and ML workflows."
content="Install 54 production-grade Agent Skills for Claude Code, Codex, OpenCode, and Pi, with an opt-in native sandbox runner for contained commands."
>
<meta name="author" content="Wayner Barrios">
<meta name="robots" content="index, follow, max-image-preview:large, max-snippet:-1">
@@ -62,7 +62,7 @@
href="https://fonts.googleapis.com/css2?family=Barlow+Condensed:wght@600;700;800&amp;family=IBM+Plex+Mono:wght@400;500;600;700&amp;display=swap"
rel="stylesheet"
>
<link rel="stylesheet" href="styles.css?v=0.4.0-responsive-prompt-1">
<link rel="stylesheet" href="styles.css?v=0.5.0-sandbox-1">
<script type="application/ld+json">
{
@@ -86,7 +86,7 @@
"description": "A curated collection of 54 Agent Skills for code review, security auditing, feature development, frontend design, MCP authoring, and machine-learning workflows.",
"codeRepository": "https://github.com/waybarrios/opencode-power-pack",
"downloadUrl": "https://www.npmjs.com/package/@waybarrios/opencode-power-pack",
"softwareVersion": "0.4.0",
"softwareVersion": "0.5.0",
"runtimePlatform": ["Claude Code", "Codex", "OpenCode", "Pi"],
"programmingLanguage": ["Markdown", "JavaScript", "Python"],
"license": [
@@ -145,6 +145,14 @@
"@type": "Answer",
"text": "Yes. Run npx @waybarrios/opencode-power-pack install followed by the skill name. The installer also includes required companion skills."
}
},
{
"@type": "Question",
"name": "Does the sandbox work with Codex and OpenCode?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Yes. Codex and OpenCode can explicitly run commands through the shared sandbox CLI on supported Linux and macOS hosts. Automatic routing and whole-agent isolation are not yet implemented."
}
}
]
},
@@ -188,6 +196,7 @@
<a href="docs/#npm">Install</a>
<a href="#profiles">Profiles</a>
<a href="#platforms">Platforms</a>
<a href="docs/#sandbox">Sandbox</a>
<a href="#skills">Skills</a>
<a href="#quality">Quality</a>
<a href="docs/">Docs</a>
@@ -200,7 +209,7 @@
<main id="main">
<section class="hero" id="top" aria-labelledby="hero-title">
<div class="hero-copy">
<p class="eyebrow">[ OPEN SOURCE · v0.4.0 · MIT + APACHE-2.0 ]</p>
<p class="eyebrow">[ OPEN SOURCE · v0.5.0 · MIT + APACHE-2.0 ]</p>
<h1 id="hero-title">
One power pack.<br>
<span>Every coding agent.</span>
@@ -383,6 +392,7 @@ Phase 6: verify and report.
<a href="docs/#how-skills-work">Learn how Agent Skills work <span aria-hidden="true">→</span></a>
<a href="docs/#npm">Installation examples <span aria-hidden="true">→</span></a>
<a href="docs/#agent-install">Let your agent install it <span aria-hidden="true">→</span></a>
<a href="docs/#sandbox">Run a contained command <span aria-hidden="true">→</span></a>
<a href="#profiles">Browse skill packs <span aria-hidden="true">→</span></a>
<a href="#profiles">Who each pack is for <span aria-hidden="true">→</span></a>
</nav>
@@ -398,8 +408,8 @@ Phase 6: verify and report.
<section class="proof-strip" aria-label="Project facts">
<div><strong>54</strong><span>curated skills</span></div>
<div><strong>4</strong><span>agent hosts</span></div>
<div><strong>362</strong><span>automated tests</span></div>
<div><strong>0</strong><span>runtime dependencies</span></div>
<div><strong>400</strong><span>automated tests</span></div>
<div><strong>4</strong><span>sandbox profiles</span></div>
</section>
<section class="section install-section" id="profiles" aria-labelledby="install-title">
@@ -642,7 +652,7 @@ Phase 6: verify and report.
</div>
<ol class="quality-list">
<li><b>01</b><span><strong>54 / 54</strong> official Agent Skills validations</span></li>
<li><b>02</b><span><strong>362</strong> automated behavioral and packaging tests</span></li>
<li><b>02</b><span><strong>400</strong> automated behavioral, packaging, and sandbox tests</span></li>
<li><b>03</b><span><strong>Strict</strong> Claude plugin and marketplace validation</span></li>
<li><b>04</b><span><strong>Minimum + latest</strong> OpenCode smoke coverage</span></li>
<li><b>05</b><span><strong>Immutable</strong> upstream provenance and license records</span></li>
@@ -688,6 +698,15 @@ Phase 6: verify and report.
The <a href="docs/skills/">complete skill reference</a> provides a copyable command for every ID.
</p>
</details>
<details>
<summary>Does the sandbox work with Codex and OpenCode?</summary>
<p>
Yes. Codex and OpenCode can explicitly invoke the same lightweight native runner with
<code>opencode-power-pack sandbox exec</code> on supported Linux and macOS hosts. It contains
that command and its descendants. It does not yet reroute every agent tool automatically or
claim whole-agent isolation. <a href="docs/#sandbox">Read the sandbox guide.</a>
</p>
</details>
</div>
</section>
@@ -718,9 +737,9 @@ Phase 6: verify and report.
<a href="llms.txt">AI summary</a>
<a href="https://github.com/waybarrios/opencode-power-pack/blob/main/LICENSE">License</a>
</nav>
<span>v0.4.0 // 2026</span>
<span>v0.5.0 // 2026</span>
</footer>
<script src="app.js?v=0.4.0-responsive-prompt-1" defer></script>
<script src="app.js?v=0.5.0-sandbox-1" defer></script>
</body>
</html>
+16 -2
View File
@@ -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 <profile-name>
- `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.
+36 -4
View File
@@ -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
+6 -4
View File
@@ -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 <skill-id>`.
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
+3 -3
View File
@@ -5,7 +5,7 @@
>
<url>
<loc>https://skills.waybarrios.com/</loc>
<lastmod>2026-08-13</lastmod>
<lastmod>2026-08-17</lastmod>
<changefreq>weekly</changefreq>
<priority>1.0</priority>
<image:image>
@@ -15,13 +15,13 @@
</url>
<url>
<loc>https://skills.waybarrios.com/docs/</loc>
<lastmod>2026-08-13</lastmod>
<lastmod>2026-08-17</lastmod>
<changefreq>weekly</changefreq>
<priority>0.9</priority>
</url>
<url>
<loc>https://skills.waybarrios.com/docs/skills/</loc>
<lastmod>2026-08-13</lastmod>
<lastmod>2026-08-17</lastmod>
<changefreq>weekly</changefreq>
<priority>0.9</priority>
</url>