Skip to content

Configuration

Jump to bottom
sarr-io edited this page Jun 9, 2026 · 20 revisions

Configuration

Zinc configuration is declared in config.yaml stored either at the local workspace level (<workspace>/.zinc/config.yaml) or the global level (~/.zinc/config.yaml).

Schema

mode: build     # Interception mode (inspect, open, build)
scope: project  # Access scope (project, home, system)

Interception Modes

The configuration mode determines how command permissions are handled in the REPL:

  • inspect: Read-only mode. Standard diagnostic commands (like pwd, ls, cat, rg, git status) are allowed. Modifying commands are denied by default.
  • build: Development mode. Building/testing commands (like zig build, npm run build, zig build test) are allowed. Risky/destructive commands (like rm, chmod, npm install) require explicit confirmation.
  • open: Permissive mode. All commands are allowed by default.

Scopes

Scopes define the filesystem boundaries allowed for execution:

  • project: Actions are restricted to the local workspace folder.
  • home: Actions are restricted to the home directory.
  • system: Actions can touch any part of the system.

Clone this wiki locally