agent_00

package module
v1.0.57 Latest Latest
Warning

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

Go to latest
Published: Sep 23, 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 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.

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; a namespace permission failure is an infrastructure blocker, not a prompt or repository failure. Check the sandbox with codex sandbox -- /bin/true in the actual container before dispatching work. The runner keeps workspace-write enforcement and does not disable the 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.

Local Build

Requires Go 1.26.5 or newer plus git, gh, and the selected agent CLI.

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

Local harness hub listens on 127.0.0.1:7777 by default.

With GitHub auth configured, local hub 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.

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.
  • MOLTEN_HUB_TOKEN: remote Hub agent token.
  • MOLTEN_HUB_REGION: na or eu; defaults to na.
  • MOLTEN_HUB_URL: explicit hosted Hub API URL, https://na.hub.molten.bot/v1 or https://eu.hub.molten.bot/v1.
  • MOLTEN_HUB_SESSION_KEY: runtime config session key; defaults to main.
  • HARNESS_AGENT_HARNESS: default agent harness.
  • HARNESS_AGENT_COMMAND: default agent executable.
  • OPENAI_API_KEY: Codex login bootstrap.
  • MOLTEN_HUB_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.

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
hub
web

Jump to

Keyboard shortcuts

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