Octopus

Keep the main agent focused on the goal. Let local tentacles handle files, browsers, commands, checks, and messy tool work.

Install and open locally Read docs tutorial
GoalThe main model keeps the objective and asks for the next useful result.
->
WorkerA tentacle reads files, runs tools, checks output, or talks to the browser.
->

Local Goal/Need/Feed App

One binary

Install, run the first Goal, and open the app from the same CLI.

One local surface

The app, pet, docs, recipes, and installer route ship together.

One visible loop

A Goal becomes a Feed summary and a pixel Octopus state.

Follow the local install path

What Makes It Different

Clean brain

The main model stays on the goal and the next useful result.

Thinking tentacles

Tool work happens close to files, browsers, commands, and checks.

Editable harness

The tool side can change while the core loop stays stable.

The Octopus Shows State

Alive

A pixel Octopus changes color when the local loop is running.

Remembering

Memory events are shown in the pet UI.

Learning

Routes and tool runs can surface as color state while the main loop stays clean.

Open the pixel pet

Quick Install & Use

curl -fsSL https://dangozhang.github.io/Octopus/install.sh | sh
	octopus --version
	octopus start --check
	octopus first-run "make this repo easier to use"
octopus start --open

The local app opens at http://127.0.0.1:8765/app.html with Goal, Need, and Feed. Docs tutorial. 5-minute use guide. Full install guide. Local App.