agent_00

package module
v1.0.92 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 3, 2026 License: MIT Imports: 0 Imported by: 0

README

Agent_00

The highest velocity way to make code changes. Run AI coding agents against GitHub repositories, prompt to PR. Product details live at molten.bot/agent_00.

Quick Start

Docker
docker run -p 7777:7777 \
  --cap-drop=ALL \
  --security-opt seccomp=unconfined \
  --security-opt apparmor=unconfined \
  moltenai/agent_00:latest
Docker Compose with Prompt Dictation
cp .env.example .env
docker compose up

For a local image build instead of the published Docker Hub image:

docker compose -f docker-compose.yml -f docker-compose.local.yml up --build

The Compose stack runs agent_00 with a linuxserver/faster-whisper sidecar. The web UI probes faster-whisper:10300; when it is reachable, the Prompt Studio shows a microphone button that appends dictated text to the prompt field. The Compose sidecar disables Docker log capture because wyoming-faster-whisper logs transcript text at INFO level. The bundled sidecar defaults to the base-int8 model and English language hints for more reliable short-form dictation; set both WHISPER_LANG=auto and WHISPER_SPEECH_LANGUAGE=auto to use Whisper language detection.

Microphone requirements

Whisper dictation records through navigator.mediaDevices.getUserMedia, which browsers expose only to secure contexts. Reaching the UI over plain http:// on a LAN address (for example http://192.168.1.10:7777) disables microphone capture in every browser, including Safari, Chrome, and Firefox. Put the UI behind HTTPS (a tunnel or reverse proxy) to record from a phone; on the machine running the harness, http://localhost:<port> is already a secure context.

Browsers that do expose getUserMedia can still refuse it when the button is tapped - permission blocked, no usable input, or an iOS browser that does not hand WKWebView the microphone. Third-party iOS browsers vary by version, so the UI does not assume the outcome: it tries to record, and only falls back when the request is actually refused. Safari on iOS remains the most reliable option for Whisper.

On iOS and Android, when capture is unavailable - up front or after a refusal - the microphone button stays usable and points at native dictation: it focuses the prompt and explains the limitation so the keyboard's dictation key (microphone icon) can be used to speak into the prompt instead. A refusal is not final: dismissing a permission prompt looks the same as blocking it, so the next tap asks for the microphone again. The same fallback covers an unreachable whisper sidecar on phones and tablets, where native dictation needs no server and the software keyboard carries a dictation key; a desktop keyboard has no such key, so there the button disappears with the sidecar as before. Set WHISPER_SPEECH_DISABLED to hide the button entirely.

Library settings

Open Settings → Library to add a private library repository and choose its name. Its tasks appear under that name in tabs to the left of the built-in categories. An explicit task displayName is preserved; otherwise the task title is derived from the source name and task slug.

Turn off Show default library and save to hide built-in tasks from the picker. The setting persists across restarts and leaves custom tasks available. Existing schedules for built-in tasks continue to run; delete a schedule to stop its recurring runs.

Recurring library tasks

On the Library page, choose a repository and use the clock beside a task to schedule it every 1–168 hours. Schedules opens the list to edit the interval or delete a recurrence. Run continues to launch a one-time task.

Schedules are stored in the app's config.json under library_schedules, keyed by task slug and canonical GitHub repository (task-slug@owner/repo). SSH and HTTPS URLs for the same repository share one schedule. Each run uses the current library prompt and the saved branch, directory, and reviewers.

The first run is due one interval after saving; editing resets the next run time. Keep the app running for schedules to execute (checked every 30 seconds). After downtime, one overdue run resumes without replaying every missed interval. A run waits while the same task and repository are already pending, running, or paused. Submission failures appear in the schedules dialog and retry at the next interval. Deleting a schedule leaves any run already started intact.

Workspace storage

Retained task checkouts need disk capacity. For long-running Docker installations, mount a persistent volume at the configured workspace base. Do not point both HARNESS_WORKSPACE_RAM_BASE and HARNESS_WORKSPACE_DISK_BASE at the same small tmpfs: accumulated tasks can fill it and prevent even git clone from starting. Linux workspace allocation checks for at least 512 MiB free on each allocation and falls back to the configured disk base when the preferred base is full. This reserve is an early check, not a limit on an individual build's disk usage. Storage exhaustion requires an infrastructure repair and does not launch another coding task on the same exhausted filesystem.

Codex sandboxing needs nested user/mount namespaces supported by the container runtime. The image uses Codex's bundled bubblewrap helper. The startup warning about missing bwrap on PATH does not itself mean command execution failed. Docker's default seccomp profile blocks namespace creation, and its default AppArmor profile blocks the sandbox mounts. Compose and the Docker command above relax these two outer profiles for the agent container. This reduces Docker's defense in depth; the container runs as node with all Linux capabilities dropped, and Codex keeps its workspace-write filesystem enforcement. Hosts with custom security policies can use profiles that permit bubblewrap's nested namespaces and mounts instead. Host user namespace support is still required.

Agent work can write only inside its allocated task directory (the parent of that task's cloned repositories). Temporary files, home directories, and build caches live under .agent00-agent-io inside that directory. The harness overrides Codex's writable roots, excludes global /tmp and implicit $TMPDIR access, and sets approvals to never so commands cannot escalate outside the task. Existing operator config cannot add extra writable roots. Multi-repository tasks share their own task parent; other tasks remain read-only.

Claude runs through codex sandbox with the same task boundary, including its child processes. This requires the Codex CLI even when selecting Claude; both CLIs are included in the Docker image. Missing or failed sandbox tooling stops the run. The trusted Codex CLI still saves login rotation and session state to the persistent CODEX_HOME; model-issued commands cannot write there.

Keep the bundled helper in this image: Debian trixie's bubblewrap 0.12.0 fails to mount /proc under Docker's masked proc paths in our container smoke check, while Codex 0.147.0's bundled helper succeeds with the security options above.

Recreate an existing container to apply security options; restarting it does not change them. For Compose, run docker compose up -d --force-recreate agent_00. Pulling a newer image also does not change an existing container's security options. Check the container you actually run tasks in:

docker inspect YOUR_CONTAINER --format '{{json .HostConfig.SecurityOpt}}'

If this prints null or [], recreate it with the two security options above (or equivalent custom profiles), retaining its configuration/workspace volumes. Check the sandbox in the actual container before running work:

docker compose exec agent_00 codex sandbox \
  -c 'sandbox_mode="workspace-write"' -- /bin/true

To verify a real authenticated task against a locally built image:

docker build -t agent00-local:smoke .
./docker/smoke-test.sh agent00-local:smoke YOUR_AUTHENTICATED_CONTAINER

The smoke check runs an isolated container with the documented security options, checks Codex and Claude filesystem boundaries, then invokes Codex with the harness's task environment and command. It requires the source container's persisted login at /workspace/config/home/.codex, shares its session lock, and verifies that a shell task creates the expected file. It makes a provider request but does not clone, push, create a PR, or launch the local server. It does not change the source container's security options; the source still needs recreation if its own sandbox check fails.

Run the repository build, full test suite and Go race tests inside the task sandbox as a separate check; this requires no provider login:

./docker/validate-sandbox.sh agent00-local:smoke

This uses the current source, keeps PID isolation and task-only writable roots, and runs the container with all Linux capabilities dropped. The runtime includes GCC and libc headers for cgo and go test -race; the shipped harness is still built with CGO_ENABLED=0. Bootstrap reads its own valid environment variables. Malformed Compose KEY:value entries are ignored, matching the documented environment format; bootstrap does not recover them from another process.

A namespace or sandbox mount permission failure is an infrastructure blocker, not a prompt or repository failure. The runner does not disable the Codex sandbox on errors. For jobs that fetch source sites or dependencies, the operator can enable sandbox_workspace_write.network_access = true in the persistent Codex config.toml; filesystem enforcement remains enabled. The image installs both Chromium and its headless shell so default Playwright launches work.

Optional commit signing

Open Settings → Commit signing to paste an SSH private key and its passphrase (if protected), then choose Save signing settings. Ed25519, RSA, and ECDSA keys are supported. The app validates the key and tests local signing. Copy the public key shown in Settings into the same GitHub account under SSH and GPG keys → New SSH key, choosing Signing Key, then use Check registration. Enable Sign commits for all tasks and save again. GitHub authentication still uses the existing token; the signing key is a separate credential.

Signing is off by default. When enabled, it applies to tasks that start after saving, including scheduled tasks, review fixes, agent-created commits, merges, and empty-repository initialization. The signing identity uses the authenticated GitHub account and its ID-based noreply email. Setup errors stop the task, and unsigned or invalid newly created commits stop publication. Existing commits are not rewritten; this setting does not repair an existing PR's unsigned history or resolve its review conversations. Confirm GitHub's Verified badge on a new PR.

The app saves an unlocked private key for unattended signing, even when the imported key has a passphrase. The passphrase is never saved. Keys live in a signing/ directory beside the runtime config.json, with directory permissions 0700 and key permissions 0600; the JSON stores only metadata and a key reference. The public key and fingerprint are visible in Settings; the private key is never returned to the browser. Disabling retains the key. Replacing it retains previous key files so running tasks can finish with their original signing configuration. Treat backups of this configuration directory as credentials.

Native installations need Git 2.34+ and ssh-keygen on PATH. The Docker image already includes the required tools; keep the whole configuration directory on its persistent volume so config.json and signing/ survive recreation. The run and multiplex CLI modes read the same signing settings from HARNESS_RUNTIME_CONFIG_PATH (default ./.agent00/config.json). No signing secrets belong in task JSON. Git settings are applied to subprocesses without changing the host's global Git configuration.

Enable or disable signing in Settings → Commit signing. The saved preference applies across restarts and to serve, run, and multiplex. HARNESS_COMMIT_SIGNING_ENABLED is no longer used; remove it from existing Compose configurations and manage signing in the app.

When signing is required but setup is incomplete, serve still starts and the local UI stays reachable. The browser opens on Settings → Commit signing, that section states why signing is blocked, and task submissions are refused until a signing key is saved; no restart is needed once it is. Startup still stops on signing configuration that the UI cannot fix, such as an unreadable runtime configuration or an environment-supplied private key that fails the import, identity, or registration checks. Tasks also recheck signing before running, so a key that is saved but unregistered or unusable still stops the task rather than producing unsigned commits.

To provision a key at boot, also set HARNESS_COMMIT_SIGNING_PRIVATE_KEY to the literal multiline SSH private key, or HARNESS_COMMIT_SIGNING_PRIVATE_KEY_FILE to a readable path inside the container (for example, a mounted secret). Use only one key source. Set HARNESS_COMMIT_SIGNING_PASSPHRASE when the supplied key is encrypted. The same Settings import, identity, and registration checks apply; register the public key on GitHub before starting with signing enabled. These variables work in serve, run, and multiplex and are read at startup. The key is copied into the managed signing directory; only metadata is written to runtime JSON, and the passphrase is never saved. Provisioning a private key does not enable signing; the saved Settings preference still controls it.

Persistent Codex authentication

Sign in once through the UI. Login and every Codex task use the same persistent CODEX_HOME (default /workspace/config/home/.codex in Docker). Codex saves rotated tokens there for subsequent tasks; credentials are never copied into task worktrees. The Compose configuration volume retains the login across container restarts. Mount /workspace/config when using plain docker run if you also need credentials to survive container replacement. Custom CODEX_HOME locations must be writable and mounted if persistence across replacement is needed.

Codex invocations sharing a home run one at a time under a process-safe session lock, including device login. Git preparation and other task stages may still run concurrently. Waiting for the lock is cancelable and does not consume the agent execution timeout. The child retains the lock if the harness exits; the kernel releases it after the child exits. Do not delete the lock file to unblock tasks. Run external Codex clients with a separate login/home rather than sharing this container's credentials across machines.

If a login is revoked, expired, or rejected, tasks stop with an authentication requirement and do not launch an automatic repair agent. Complete device login again in the UI, or replace the file-based login using the same CODEX_HOME inside the container. Keyring-backed logins should recover through the UI. A fresh login clears the blocked credential generation. Existing already-used refresh tokens need this one-time recovery after upgrading; persistence cannot restore a token that the provider has invalidated.

Claude authentication diagnostics

Claude login and tasks share the persistent CLAUDE_CONFIG_DIR (default $HOME/.claude). Tasks keep their own temporary home and caches, but do not copy Claude credentials: a refresh in one task must be visible to the next. The Docker configuration volume retains the shared session across restarts.

The Claude CLI refuses to start when .claude.json is missing from that directory, whatever credentials are configured. When Claude's own backups/.claude.json.backup.* copies are still present, the harness restores the newest readable backup before running a task and when reporting auth status; it never overwrites an existing configuration file, and a first run with no file and no backups is left to the CLI. If the file cannot be restored (for example a read-only configuration volume), the task stops at the authentication stage with the cp command to run, instead of failing later with an opaque agent exit status.

The local UI exposes these debugging endpoints:

  • GET /healthz: service health.
  • GET /api/agent-auth: current login state and interactive sign-in challenge.
  • GET /api/agent-auth/diagnostics: read-only Claude diagnostics, including checks[].code, severity (status), description, suggested next action, CLI login status and exit code, login-process state, and credential expiry. It excludes tokens, browser codes, login URLs, account identity, and raw CLI output, and sends Cache-Control: no-store.
  • GET /api/state: task statuses, exit codes, errors, and tasks[].logs[].text.

For example, with the default local port:

curl -s http://127.0.0.1:7777/api/agent-auth/diagnostics

Diagnostic codes include CLAUDE_AUTH_REJECTED, CLAUDE_CREDENTIALS_EMPTY, CLAUDE_ACCESS_TOKEN_EXPIRED, CLAUDE_BROWSER_CODE_INVALID, CLAUDE_CONFIG_FILE_MISSING, CLAUDE_LOGIN_PROCESS_FAILED, and CLAUDE_STATUS_UNAVAILABLE. A successful HTTP response means diagnostics were collected, not that login is healthy. Inspect the checks. cli.logged_in means Claude has a stored login; it does not prove a refresh or inference request will succeed. An expired access token with a refresh token is a warning until Claude attempts refresh.

Local Build

Requires Go 1.26.5 or newer plus git, gh, and the Codex CLI. Claude tasks also require the Claude CLI; Codex provides their filesystem sandbox.

go build -o bin/harness ./cmd/harness
./bin/harness serve

Local harness serve listens on 127.0.0.1:7777 by default.

With GitHub auth configured, local server mode also watches GitHub review-request notifications by default. When the authenticated GitHub user is still requested as a PR reviewer, the harness queues the bundled code-review task and posts a summary comment back to the original PR. Auto-merge is off by default; opt in with review_watch.auto_merge: true in the runtime config.

For a manual code-review task, select the PR's head branch or include its PR URL. The review is read-only and posts back to that PR; a clean worktree is a successful review, not a reason to queue a repair task. Free-text requests such as "fix the comments in the review" also use the selected head branch or PR URL to update the existing PR. If that target cannot be resolved or updated, the harness reports the targeting error instead of opening a replacement PR.

Post-task PR review cycles are also off by default. Configure review_watch.review_level as off, low, medium, or high to run 0 or up to 1, 3, or 6 review passes after a task creates its pull request and initial checks finish. A pass with no negative findings ends the cycle early. Actionable findings are repaired and checked before the next pass; final-pass findings are repaired and checked without an extra pass.

Go Module

Agent_00 is distributed as a Go module from this Git repository. Install the latest stable release from the renamed module path.

go get github.com/Molten-Bot/agent_00@latest
go install github.com/Molten-Bot/agent_00/cmd/harness@latest

Bundled Tools

The Docker image includes railsmith, an npm CLI for creating and maintaining repository AGENTS.md guardrails. Container startup also seeds a Codex skill from the package's AGENT_GUIDE.md into the persisted Codex home so agents can activate Railsmith guidance during coding sessions.

railsmith guide
railsmith doctor --root .
railsmith diff --root . --mode detailed
railsmith check --root .

The image also includes git-changes-by-day, a Go CLI for exporting git history to CSV. Agents can use it when a task needs per-commit change data.

git-changes-by-day -repo /path/to/repo -text-out /tmp/commit-text.csv

The CSV includes UTC datetime/date columns, commit metadata, changed file counts, and line change counts.

The image includes Playwright's full Chromium build without the legacy headless-shell download. For headless runs, select Playwright's new headless mode with channel: "chromium" in playwright.config or the equivalent launch option.

Environment Variables

Useful environment variables:

  • GITHUB_TOKEN or GH_TOKEN: GitHub auth for clone, push, PRs, and checks.
  • HARNESS_AGENT_HARNESS: default agent harness.
  • HARNESS_AGENT_COMMAND: default agent executable.
  • OPENAI_API_KEY: Codex login bootstrap.
  • HARNESS_DEFAULT_REPOSITORY: optional repository prefill for Prompt Studio; omitted leaves the repository field empty.
  • WHISPER_SPEECH_HOST: optional speech sidecar host; defaults to faster-whisper.
  • WHISPER_SPEECH_PORT: optional speech sidecar Wyoming port; defaults to 10300.
  • WHISPER_SPEECH_LANGUAGE: optional speech language hint; defaults to en. Set to auto to use Whisper language detection.
  • WHISPER_SPEECH_TIMEOUT_SECONDS: optional speech transcription timeout in seconds; defaults to 120.
  • WHISPER_SPEECH_DISABLED: set to true to hide prompt dictation, including the native keyboard dictation fallback button.

Response Modes

Supported responseMode values:

  • default
  • off
  • caveman-lite
  • caveman-full
  • caveman-ultra
  • caveman-wenyan-lite
  • caveman-wenyan-full
  • caveman-wenyan-ultra

Omitted or default maps to caveman-full. The harness prepends the bundled Caveman skill to the agent prompt unless responseMode is off.

Development

go test ./...

Documentation

Overview

Package agent_00 identifies the agent_00 module for Go module consumers.

Directories

Path Synopsis
cmd
harness command
internal
app
customlibrary
Package customlibrary pulls company-owned library tasks from a private git repository's ./prompt/*.md files and converts them into the same library.TaskDefinition shape used by the built-in ./library/*.json catalog.
Package customlibrary pulls company-owned library tasks from a private git repository's ./prompt/*.md files and converts them into the same library.TaskDefinition shape used by the built-in ./library/*.json catalog.
gitsigning
Package gitsigning manages optional SSH commit signing without changing global Git configuration.
Package gitsigning manages optional SSH commit signing without changing global Git configuration.
stringsx
Package stringsx holds small string helpers shared across internal packages and cmd/harness, to avoid re-implementing the same logic in each caller.
Package stringsx holds small string helpers shared across internal packages and cmd/harness, to avoid re-implementing the same logic in each caller.
web

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL