FrostCandy Home
AgentGO Workspace

DOWNLOAD AgentGO

Download the AgentGO distribution package, unzip it, run the included executable, and open AgentGO in your browser at http://localhost:5226.

DOWNLOAD AgentGO.zip
Package includes the AgentGO (Mac/Linux/Windows) executable,
default configuration files, templates, assets, and system prompts.
Latest revision provides more support for video and 3d mesh opperations.
- 3d mesh tested with tripo and fal.ai API's.
- video tested with Google Vertex API.

Revision: 343 - SHA256 Verification:
303e163592e30826440026e3b2ca0f43855d7343bf07595575b8223b3c49a2fe
Windows: certutil -hashfile AgentGO.zip SHA256
Linux/macOS: sha256sum AgentGO.zip
Start here

Start with what you want AgentGO to do.

Choose a workflow path for code projects, model comparison, large-project Cypher context, research with WireTap, deeper reasoning with DoubleTap, single-file DeadDrop revision, automation with Outfits, or media generation.

1. Pick the goal

Choose the path that matches the job: build, compare, research, revise, automate, or generate media.

2. Learn the core flow

AgentGO centers on projectwork, Builders, context, execution, human review, and controlled merges.

3. Expand only what matters

Open the chapters that fit the task instead of reading the entire product guide at once.

Choose your AgentGO path

What do you want to do?

Each path jumps to the chapter that best matches the user's goal. This gives the page a product-tour feeling without hiding the full manual.

Feature explorer

All AgentGO features, grouped by user flow.

Search the guide, open only the chapters you need, or use the path cards above to jump into the right section.

Showing all sections.
No matching AgentGO sections found. Try a broader term like “model”, “project”, “research”, “file”, or “workflow”.
Developer resources

Need setup or endpoints?

Installation and REST endpoint details are still included below, but now users can jump directly to them from the sticky navigation.

Installation

Build commands, required package structure, and first-run folder behavior.

Jump to Installation →

REST Endpoints

Local UI routes, public Outfit automation routes, diagnostics, projects, files, and media endpoints.

Jump to API →

AI Guide

Official AI-readable AgentGO reference for assistants, agents, and product Q&A.

Open AI Guide →

INSTALLATION

AgentGO is built as a Go executable. After building the executable for your operating system, package it with the required runtime folders and configuration files.

Windows 11

go build -o agentgo.exe

Linux 64-bit Intel / AMD

GOOS=linux GOARCH=amd64 go build -o agentgo-linux-amd64

Linux ARM64

GOOS=linux GOARCH=arm64 go build -o agentgo-linux-arm64

macOS Apple Silicon

GOOS=darwin GOARCH=arm64 go build -o agentgo-macos-arm64

macOS Intel

GOOS=darwin GOARCH=amd64 go build -o agentgo-macos-amd64

Required Package Structure

AgentGO/
  agentgo executable
  config.json
  models.json
  version.json

  templates/
    index.html

  assets/
    agentgo_logo.png
    frostcandy_logo_font.png
    fc_agentgo_bg.png
    fc_agentgo_yetti.png
    Ugg1.png
    Ugg2.png
    bat_01.png
    bat_02.png
    pumpkin01.png
    pumpkin02.png
    readme/
      01-ai-prompt-input.png
      02-ai-models.png
      03-logs-output.png
      04-file-manager-root.png
      05-knowledge-drawer-notes.png
      06-agentgo-templates.png
      07-project-manager.png
      08-import-into-project.png
      09-merge-review.png
      10-include-context.png

  system_prompts/
    deaddrop_balanced.txt
    deaddrop_low.txt
    sys1_builder_balanced.txt
    sys1_builder_low.txt
    sys1_helper_balanced.txt
    sys1_helper_low.txt
    sys1_observer_balanced.txt
    sys1_observer_low.txt
Note: AgentGO creates the work/ and work/projects/ folders automatically on first run. The adapters/, tools/, *.go, go.mod, and go.sum files are source/development files and are not required in a normal user package.

AgentGO REST ENDPOINTS

AgentGO runs a local web server, usually at http://localhost:5226. These endpoints are used by the AgentGO interface and can also be called by local tools, scripts, and external automation when appropriate.

Most /api/... routes are local app endpoints intended for the AgentGO UI. The /outfits/... routes are the main public automation endpoints for external tools.
Models and Model Metadata
MethodEndpointPurpose
GET/api/modelsList configured models and current model state.
GET/api/models/definitionsReturn provider, adapter, and model setup definitions.
POST/api/models/createCreate a new model configuration.
POST/api/models/updateUpdate an existing model configuration.
POST/api/models/deleteDelete a model configuration.
POST/api/models/toggleEnable or disable a model for the next run.
POST/api/models/run-orderSet model run order for waves.
POST/api/reviewerTurn Observer / Reviewer mode on or off for a model.
GET / POST/api/model-metaRead or save model metadata files such as user context, AI context, and reviewer context.
Prompting, Chat, Execution, and Run State
MethodEndpointPurpose
POST/api/executeExecute the main prompt against active Builders, including armed execution modes such as Cypher, WireTap, or DoubleTap.
POST/api/stopStop the active run.
POST/api/chatSend a model-specific Chat to AI request.
POST/api/chat/prompt-helperAsk AI to improve or reshape a prompt.
POST/api/chat/role-ideasGenerate role ideas for AI model setup.
GET / POST/api/builder-outputRead or update Builder output state.
GET / POST/api/reviewer-outputRead or update Observer / Reviewer output state.
GET / POST/api/riskRead or update Risk Mode settings.
POST/api/workflow/endEnd or clear the current workflow state.
GET/api/wave-stateRead current wave and loop progress.
Logs and Diagnostics
MethodEndpointPurpose
GET/api/logsRead recent AgentGO logs.
POST/api/logs/toastWrite a toast-style log message.
POST/api/logs/clearClear visible logs.
GET/api/diagnostics/streamStream live diagnostics events.
GET/api/diagnostics/fileRead a diagnostics file.
Files, Context, Imports, and Downloads
MethodEndpointPurpose
GET/api/filesList files and folders in the AgentGO work tree.
GET/api/fileRead a text file.
GET/api/file/blobDownload or view a raw file blob.
POST/api/file/saveSave file content.
POST/api/file/deleteDelete a file.
GET/api/context-filesList selectable project context files.
POST/api/context/clearClear selected context and AI run context.
POST/api/project/import/uploadUpload files or ZIPs into the active project.
POST/api/project/import/gitImport a Git repository into the active project.
POST/api/project/import/urlImport a web resource by URL.
GET/api/project/downloadDownload the active project or projectwork archive.
Diff, Candidate Files, Merge, and Observer Compare
MethodEndpointPurpose
GET/api/diffRead diff summary for a model candidate.
GET/api/diff/previewPreview a candidate file change.
GET/api/observer/compare-previewPreview comparison between two model candidates.
POST/api/diff/candidate/saveSave or edit a candidate file before merge.
POST/api/diff/candidate/deleteDelete a candidate file from merge consideration.
POST/api/mergeMerge approved candidate files into projectwork.
Cypher, WireTap, DoubleTap, and DeadDrop
MethodEndpointPurpose
POST/api/cypher/buildBuild or enrich the active project's Cypher map.
GET/api/wiretap/statusRead WireTap status for the active project.
POST/api/wiretap/buildBuild or arm WireTap for research-guided runs.
MODEDoubleTap via /api/executeWhen armed in the UI, DoubleTap uses Execute Prompt to build reasoning memos, critique/refine them, and produce a final answer with a saved markdown run archive.
GET/api/deaddrop/statusRead DeadDrop status.
POST/api/deaddrop/setSet or clear the current DeadDrop target.
POST/api/deaddrop/executeRun DeadDrop revision workflow.
Projects, Session, and Knowledge Drawer
MethodEndpointPurpose
GET/api/projectsList projects and active project state.
POST/api/projects/createCreate a project.
POST/api/projects/selectSelect the active project.
POST/api/projects/deleteDelete a project.
POST/api/projects/updateUpdate project settings or limits.
POST/api/session/resetReset current session state.
GET/api/session/usageRead session usage information.
GET/api/knowledgeRead README and notes content for the Knowledge drawer.
POST/api/knowledge/notesSave Knowledge drawer notes.
Video and 3D Mesh Jobs
MethodEndpointPurpose
GET / POST/api/video/jobsList or create video generation jobs.
POST/api/video/jobs/promotePromote a video output into projectwork.
GET / POST/api/mesh/jobsList or create 3D mesh generation jobs.
POST/api/mesh/jobs/promotePromote a mesh output into projectwork.
Outfit Management Endpoints
MethodEndpointPurpose
GET/api/outfitsList saved Outfits.
POST/api/outfits/createCreate an Outfit from current settings.
POST/api/outfits/updateUpdate an Outfit.
POST/api/outfits/renameRename an Outfit.
POST/api/outfits/duplicateDuplicate an Outfit.
POST/api/outfits/deleteDelete an Outfit.
GET/api/outfits/exportExport an Outfit.
POST/api/outfits/importImport an Outfit.
POST/api/outfits/applyApply an Outfit to the current AgentGO session.
POST/api/outfits/triggersUpdate Outfit timer, webhook, callback, or trigger settings.
POST/api/outfits/cron-previewPreview a cron or timer schedule.
POST/api/outfits/webhook/regenerateRegenerate an Outfit webhook key.
Outfit Run Archive Endpoints
MethodEndpointPurpose
GET/api/outfits/runsList archived Outfit runs.
GET/api/outfits/runs/metaRead one Outfit run's metadata.
GET/api/outfits/runs/projectRead Outfit run project information.
GET/api/outfits/runs/projectwork-zipDownload an archived projectwork ZIP.
GET/api/outfits/runs/changed-files-manifestDownload changed-file manifest for a run.
GET/api/outfits/runs/changed-files-zipDownload changed files from a run.
POST/api/outfits/runs/callback-retryRetry callback delivery for a completed run.
GET/api/outfits/runs/deaddrop-finalDownload final DeadDrop output from a run.
GET/api/outfits/runs/deaddrop-zipDownload DeadDrop run outputs as a ZIP.
POST/api/outfits/runs/deleteDelete an archived Outfit run.
Public Outfit Automation API
MethodEndpointPurpose
POST/outfits/{outfit}/runStart a webhook-enabled Outfit run.
POST/outfits/{outfit}/run/deaddropStart a webhook-enabled DeadDrop Outfit run with one DeadDrop file.
GET/outfits/{outfit}/runsList public run records for an Outfit.
DELETE/outfits/{outfit}/runs/{runId}Delete one public Outfit run record.
GET/outfits/{outfit}/runs/{runId}/pull/{artifact}Pull a run artifact such as projectwork, changed files, or DeadDrop output.
GET/outfits/{outfit}/latest/pull/{artifact}Pull the latest available artifact for an Outfit.
Public Outfit authentication: external Outfit routes require an Outfit API key. Send it with X-AgentGO-Outfit-Key, X-AgentGO-Token, or Authorization: Bearer YOUR_KEY.

Note: /, /assets/..., and /favicon.ico are normal browser/static routes, not REST API routes. Also, /api/generate is commonly used as an Ollama provider path, but it is not an AgentGO server endpoint.
AI assistants and agents can read the official AgentGO AI guide:
https://agentgo.frostcandy.com/ai.html