v0.1.0-spike.1 (S12 trial)

Spike pre-release (Gate V0 / S12)

Experimental runmark — local, deterministic workspace/script facts for AI-agent shell calls. Does not execute commands or decide allow/ask/deny.

No clone required. Schema and flags may change.

Install

macOS / Linux

curl -fsSL https://github.com/phaethix/runmark/releases/download/v0.1.0-spike.1/install.sh | bash

# optional: user-level Codex PreToolUse → runmark hook codex
curl -fsSL https://github.com/phaethix/runmark/releases/download/v0.1.0-spike.1/install.sh | bash -s -- --with-codex

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

Windows (PowerShell, CLI only)

irm https://github.com/phaethix/runmark/releases/download/v0.1.0-spike.1/install.ps1 | iex
runmark version

Codex PreToolUse on Windows is unreliable today (shell often does not fire hooks). Use analyze on Windows; use macOS/Linux for hook integration.

No-Codex user scenarios (VM-friendly)

curl -fsSL https://github.com/phaethix/runmark/releases/download/v0.1.0-spike.1/demo-user-scenarios.sh | bash

Walks NL intents → agent Bash → naive guard vs runmark (with/without workspace snapshot). Does not need Codex.

Try CLI

runmark analyze 'echo hi > out.txt' --cwd logical://workspace --format text

cat > /tmp/rm-ctx.json <<'EOF'
{"cwd":"logical://workspace","files":{"package.json":"{\"scripts\":{\"build\":\"rm -rf dist\"}}"}}
EOF
runmark analyze 'npm run build' --context-file /tmp/rm-ctx.json --format text

Codex hook

After install.sh --with-codex: enable hooks in Codex config if needed, open /hooks, trust runmark facts, then ask Codex to run a simple shell write. Expect PreToolUse + facts in the transcript. Default behavior is additionalContext only (no deny/ask).

Assets

File	Platform
runmark-darwin-arm64 / runmark-darwin-amd64	macOS
runmark-linux-arm64 / runmark-linux-amd64	Linux
runmark-windows-amd64.exe / runmark-windows-arm64.exe	Windows
install.sh / install.ps1	installers
SHA256SUMS.txt	checksums

Built from 50d2bfe. See README for status and non-goals.