Skip to content
MaxGohPublic

About

Fully-Provisioned Digital Workers Capable of General Human-level tasks.

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

BotOS

MC readiness: Not ready Last evaluated: 2026-09-05.

BotOS is a self-hosted platform for persistent AI workers. You guide an agent through work, review the procedure it learns, and decide what it may do on future runs.

Each agent has its own instructions, memory, application accounts, and dedicated workstation. You can follow its work through conversation, view its screen, or take control. An overview shows all workers and their latest status.

Project status

Status: foundation. The product design and visual prototype are approved and recorded here, alongside the agent-ready foundation — instructions, decision log, verify loop, test suite, skills, and CI. This repository has no application runtime or installer yet. Implementation planning is the next deliverable.

The prototype uses illustrative playback. It does not connect to real desktops, accounts, or payment services.

Quick start

make bootstrap   # check your local toolchain
make verify      # run the full gate: static checks, then the test suite
make test        # the test suite on its own, while iterating

make verify is the only gate you need to satisfy. CI runs the same target, so green locally means green in CI. Run make help for the full list. The gate checks the foundation itself — the docs, the scripts, and the gate's own behaviour; there is no application build or application test command yet, and none is faked.

Repository layout

Path What lives there
AGENTS.md Agent + contributor contract: commands, conventions, guardrails
CLAUDE.md Relative symlink to AGENTS.md
docs/BUILD.md Current state, orientation, and available checks
docs/conventions.md Repository and development conventions
docs/design/ Approved product design, prototype, and provenance
docs/agdr/ Agent Decision Records — why things are the way they are
docs/DEPENDENCY-GRAPH.md Directory map and dependency edges
scripts/ bootstrap.sh, verify.sh, test.sh — all pure POSIX shell
tests/ The test suite: lib.sh plus one test_*.sh per area
.claude/skills/ Repo skills for the run/verify workflows
.github/workflows/ci.yml CI, which runs make verify

Dependencies

None. The foundation is make plus POSIX shell, both of which ship with the standard developer toolchain — the test suite is written in the same two things. No package manager is required to run make verify today, and no runtime dependency has been introduced. The application stack and build commands will be documented when the first implementation phase establishes them.

Contributing

See CONTRIBUTING.md. Contributors and agents share the same rules; AGENTS.md is the detailed version.

Security

Please report vulnerabilities privately — see SECURITY.md.

License

MIT © 2026 Max Goh.

About

Fully-Provisioned Digital Workers Capable of General Human-level tasks.

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages