nono-opencode-tinfoil/README.md

nono-opencode-tinfoil

A nono sandbox profile for running OpenCode with access to Tinfoil enclaves and other LLM providers.

Install

macOS / Linux

git clone https://github.com/autonomic/nono-opencode-tinfoil.git
cd nono-opencode-tinfoil
make install

This installs:

• The sandbox profile to ~/.config/nono/profiles/opencode-tinfoil.json
• A wrapper script to ~/.local/bin/opencode

Requirements

• nono installed e.g. brew install nono
• opencode installed globally — any of:
  • Homebrew: brew install opencode
  • npm: npm i -g opencode-ai
  • Volta, fnm, or any other Node version manager

How it works

you type: opencode
       ↓
~/.local/bin/opencode (wrapper)
       ↓
  scans PATH for the real opencode binary
  (skips itself — finds brew, npm, volta, etc.)
       ↓
  exec nono run --profile opencode-tinfoil --allow-cwd -- <real-opencode>
       ↓
  opencode runs inside the sandbox

The wrapper resolves the real opencode binary at runtime by scanning every directory in your PATH. It skips itself, so it works regardless of:

• Where opencode is installed (Homebrew on macOS/Linux, npm global, Volta, etc.)
• PATH ordering between the wrapper and the real binary
• opencode version bumps

You just type opencode from any project directory and it runs sandboxed.

PATH ordering

If a non-sandboxed opencode appears earlier on your PATH than the wrapper, typing opencode will bypass the sandbox. The installer detects and warns about this. Fix it with:

export PATH="$HOME/.local/bin:$PATH"

Or add an alias to your shell profile:

alias opencode="$HOME/.local/bin/opencode"

Usage

From any project directory:

opencode

Or use the profile directly with any opencode binary:

nono run --profile opencode-tinfoil --allow-cwd -- opencode

You can also point it at a specific binary:

# Homebrew (macOS)
nono run --profile opencode-tinfoil --allow-cwd -- /opt/homebrew/bin/opencode

# Homebrew (Linux)
nono run --profile opencode-tinfoil --allow-cwd -- /home/linuxbrew/.linuxbrew/bin/opencode

# npm global
nono run --profile opencode-tinfoil --allow-cwd -- $(npm root -g)/opencode/bin/opencode

TUI

A terminal UI for managing the sandbox profile and checking environment status.

Run from the repo

make tui

Install for use from anywhere

Build and install the binary to ~/.local/bin/nono-tui:

make tui-install

Then run from any directory:

nono-tui

Make sure ~/.local/bin is on your PATH:

export PATH="$HOME/.local/bin:$PATH"

The TUI reads and edits the installed profile at ~/.config/nono/profiles/opencode-tinfoil.json, so it works regardless of your current directory.

What it does

The TUI has two tabs:

Dashboard — Shows live status of your sandbox setup at a glance:

  ✓  nono installed              /home/linuxbrew/.linuxbrew/bin/nono nono 0.x.x
  ✓  profile installed            ~/.config/nono/profiles/opencode-tinfoil.json
  ✓  wrapper installed            ~/.local/bin/opencode
  ✗  wrapper first on PATH        resolves to /opt/homebrew/bin/opencode
  ✓  opencode binary              /opt/homebrew/bin/opencode
  ✓  tinfoil credentials           ~/.tinfoil

  > Launch opencode in sandbox
    Validate profile
    Refresh checks

Use j/k to navigate the action list, l to launch opencode in the sandbox, v to validate the profile, and r to re-run all checks.

Editor — Edit the installed profile (~/.config/nono/profiles/opencode-tinfoil.json) with four sub-tabs:

Sub-tab	Key	What you can edit
Commands	1	Allowed binaries (git, node, npm, ...) and blocked binaries (sudo, su, mkfs, ...)
Filesystem	2	Allowed, read-only, write, and denied paths
Network	3	Allowed domains (*.tinfoil.sh, api.openai.com, ...) and network block toggle
Environment	4	Set environment variables and denied env vars

Changes are applied to the live installed profile — they take effect on the next opencode launch. Press s to save (which also runs nono profile validate). Saved files are written as clean JSON (comments are stripped).

Keybindings

Key	Action
Tab	Switch between Dashboard and Editor
1-4	Switch editor sub-tab
j/k, ↑/↓	Move cursor
←/→	Switch between lists within a sub-tab
a	Add entry
x	Remove selected entry
enter	Edit selected entry inline
b	Toggle network block (Network tab only)
s	Save profile + validate
l	Launch opencode in sandbox (Dashboard only)
v	Validate profile (Dashboard only)
r	Refresh checks (Dashboard only)
q	Quit
Q	Force quit (discard unsaved changes)

Unsaved changes are marked with * in the title. Pressing q with unsaved changes warns you; press Q to force quit.

Tinfoil integration

The profile allows network access to:

• *.tinfoil.sh
• inference.tinfoil.sh
• containers.tinfoil.sh
• ghcr.io

and grants read/write access to ~/.tinfoil for Tinfoil credentials.

Security model

• Current working directory: read/write
• OpenCode config: read/write
• Tinfoil config: read/write
• SSH private keys, AWS/GCP/Azure credentials, kubeconfig: denied
• sudo, su, doas, passwd, disk tools: denied

Uninstall

make uninstall

To also remove the TUI binary:

rm -f ~/.local/bin/nono-tui

License

GPL-3.0