atrislabs/atris

atris: you say what you want in plain words. atris builds it, checks it, and shows you proof.
Under the hood it is an operating system for AI work. It turns any repo into a workspace an agent can actually operate: shared context it reads before it acts, a plan -> do -> review loop, durable tasks and daily logs, and verification that ends work on a real check instead of a promise.
Every owner gets persistent computers to run it:
text
Owner = User | Business
Owner has many Computers
Computer = workspace + files + tools + secrets + memory + agents + validation loop
A computer can be personal or shared by a business. It can run a job like code, research, CRM, reporting, event ops, support, or business ops.
## Quick Start
bash
npm install -g atris
cd your-project
atris init && atris
## For Coding Agents
Read FORAGENTS.md first: why agents adopt Atris, 60-second start, spread-it instructions.
If you're an agent, run:
bash
atris
Then read the workspace's atris/atris.md and follow it exactly. atris.md is the source of truth.
## What Atris Gives You
An AI workspace on top of any repo
Persistent AI computers for scoped jobs
A local computer card that makes each workspace inspectable
A strict plan -> do -> review loop
Daily logs, task tracking, feature packs, and project memory
Skills, team members, integrations, and cloud sync when you need them
A plain answer to "what did my AI actually do?": run atris recap, or atris recap --share for a receipt-backed summary you can paste anywhere
## Critical Files
| File | Purpose |
| atris/atris.md | Main instructions for agents working in this repo |
| atris/MAP.md | Navigation index with file:line refs |
| atris/TODO.md | Human-readable task view |
| atris/logs/YYYY/YYYY-MM-DD.md | Daily log, inbox, notes, completions |
| atris/features/ | Feature packs with idea.md, build.md, validate.md |
| atris/skills/ | Reusable skills for agents |
| atris/team/ | Team member specs and local context |
| atris/wiki/ | Repo memory, briefs, concepts, and wiki health |
text
atris/
├── atris.md
├── MAP.md
├── TODO.md
├── logs/
├── features/
├── skills/
├── team/
└── wiki/
## Install
bash
npm install -g atris
atris --version
Requires Node.js 18+.
atris task uses built-in SQLite and requires Node.js 22+.
If you want Atris cloud workspaces, businesses, or integrations, run atris setup after install.
## How To Run Atris
bash
cd your-project
atris init
atris
atris init scaffolds the workspace, including atris/wiki/. atris loads context and hands the workflow off to atris/atris.md.
If you're still shaping the idea, use atris brainstorm. If you want Atris to finish one job and prove it worked, use atris run " ". If you want Atris to keep picking the next mission or member until you say stop, use atris autopilot. If you want project memory checked for stale pages and missing context, use atris loop. atris activate surfaces wiki state from atris/wiki/STATUS.md when it exists.
Core loop: plan -> do -> review
Integrates with any agent.
### Publish a static site
Upload any built static site to an Atris-hosted subdomain. See
docs/site-publish.md for flags, limits, profiles, and
troubleshooting.
bash
atris site publish dist --slug my-site --spa