2026-03-21 14:43:19 +00:00
<!DOCTYPE html>
< html lang = "en" >
< head >
< meta charset = "utf-8" >
< meta name = "viewport" content = "width=device-width, initial-scale=1" >
< title > Quickstart — Disinto< / title >
< meta name = "description" content = "Get from zero to your first automated PR in under 10 minutes. Prerequisites, disinto init walkthrough, and the full issue-to-merge lifecycle." >
< link rel = "icon" href = "../favicon.ico" sizes = "32x32" >
< link rel = "icon" href = "../favicon-192.png" sizes = "192x192" type = "image/png" >
< link rel = "apple-touch-icon" href = "../apple-touch-icon.png" >
< link rel = "canonical" href = "https://disinto.ai/docs/quickstart" >
< meta property = "og:title" content = "Quickstart — Disinto" >
< meta property = "og:description" content = "Get from zero to your first automated PR in under 10 minutes." >
< meta property = "og:url" content = "https://disinto.ai/docs/quickstart" >
< meta property = "og:type" content = "article" >
< style >
:root {
--bg: #0a0a0a;
--fg: #e0e0e0;
--dim: #707070;
--accent: #c8a46e;
--accent-dim: #8a7044;
--surface: #141414;
--border: #222;
--green: #4a7;
}
* { margin: 0; padding: 0; box-sizing: border-box; }
body {
font-family: 'SF Mono', 'Cascadia Code', 'Fira Code', 'JetBrains Mono', monospace;
background: var(--bg);
color: var(--fg);
line-height: 1.7;
min-height: 100vh;
}
.container {
max-width: 720px;
margin: 0 auto;
padding: 3rem 2rem;
}
/* Header */
.header {
text-align: center;
margin-bottom: 3rem;
}
.header h1 {
font-size: 2rem;
font-weight: 300;
letter-spacing: 0.2em;
text-transform: uppercase;
color: var(--accent);
margin-bottom: 0.25rem;
}
.header .subtitle {
color: var(--dim);
font-size: 0.85rem;
letter-spacing: 0.1em;
}
.header .back {
display: inline-block;
margin-top: 0.75rem;
color: var(--accent-dim);
text-decoration: none;
font-size: 0.75rem;
}
.header .back:hover { color: var(--accent); }
/* Navigation between docs */
.doc-nav {
display: flex;
justify-content: center;
gap: 1.5rem;
margin-bottom: 2.5rem;
font-size: 0.75rem;
}
.doc-nav a {
color: var(--accent-dim);
text-decoration: none;
padding: 0.3rem 0.8rem;
border: 1px solid var(--border);
}
.doc-nav a:hover { border-color: var(--accent-dim); }
.doc-nav a.active {
color: var(--accent);
border-color: var(--accent-dim);
}
/* Section */
.section {
margin-bottom: 2.5rem;
}
.section h2 {
font-size: 0.75rem;
font-weight: 600;
letter-spacing: 0.2em;
text-transform: uppercase;
color: var(--accent-dim);
margin-bottom: 1rem;
padding-bottom: 0.5rem;
border-bottom: 1px solid var(--border);
}
.section p {
color: var(--dim);
font-size: 0.85rem;
margin-bottom: 1rem;
}
.section p strong {
color: var(--fg);
}
.section ul, .section ol {
color: var(--dim);
font-size: 0.85rem;
margin-bottom: 1rem;
padding-left: 1.5rem;
}
.section li {
margin-bottom: 0.5rem;
}
.section li strong {
color: var(--fg);
}
.section a {
color: var(--accent);
text-decoration: none;
}
.section a:hover {
text-decoration: underline;
}
/* Code blocks */
pre {
background: var(--surface);
border: 1px solid var(--border);
padding: 1.2rem 1.5rem;
margin-bottom: 1rem;
overflow-x: auto;
font-size: 0.8rem;
line-height: 1.6;
color: var(--fg);
}
code {
font-family: inherit;
font-size: 0.85rem;
color: var(--accent);
}
pre code {
color: var(--fg);
font-size: inherit;
}
.comment { color: var(--dim); }
.output { color: var(--green); }
/* Step numbers */
.step-num {
display: inline-block;
width: 1.6rem;
height: 1.6rem;
line-height: 1.6rem;
text-align: center;
background: var(--accent-dim);
color: var(--bg);
font-size: 0.75rem;
font-weight: 600;
margin-right: 0.5rem;
flex-shrink: 0;
}
.step-header {
display: flex;
align-items: center;
margin-bottom: 1rem;
color: var(--fg);
font-size: 0.9rem;
}
/* Prerequisites box */
.prereqs {
background: var(--surface);
border: 1px solid var(--border);
padding: 1.5rem;
margin-bottom: 2rem;
}
.prereqs .label {
font-size: 0.7rem;
color: var(--accent-dim);
text-transform: uppercase;
letter-spacing: 0.15em;
margin-bottom: 0.75rem;
}
.prereqs ul {
list-style: none;
padding: 0;
}
.prereqs li {
color: var(--dim);
font-size: 0.85rem;
margin-bottom: 0.4rem;
padding-left: 1.2rem;
position: relative;
}
.prereqs li::before {
content: "\2610";
position: absolute;
left: 0;
color: var(--accent-dim);
}
.prereqs li strong {
color: var(--fg);
}
/* Expected output */
.expected {
background: var(--surface);
border-left: 3px solid var(--green);
padding: 1rem 1.5rem;
margin-bottom: 1rem;
font-size: 0.8rem;
color: var(--dim);
}
.expected .label {
font-size: 0.65rem;
color: var(--green);
text-transform: uppercase;
letter-spacing: 0.15em;
margin-bottom: 0.5rem;
}
.expected code {
color: var(--fg);
font-size: 0.8rem;
}
/* Lifecycle diagram */
.lifecycle {
background: var(--surface);
border: 1px solid var(--border);
padding: 1.5rem;
margin-bottom: 1.5rem;
font-size: 0.8rem;
color: var(--dim);
text-align: center;
overflow-x: auto;
}
.lifecycle .step {
color: var(--accent);
}
.lifecycle .arrow {
color: var(--border);
margin: 0 0.3rem;
}
.lifecycle .agent {
color: var(--dim);
font-size: 0.65rem;
display: block;
margin-top: 0.3rem;
}
/* Footer */
.footer {
text-align: center;
padding-top: 2rem;
border-top: 1px solid var(--border);
font-size: 0.7rem;
color: var(--dim);
}
.footer a {
color: var(--accent-dim);
text-decoration: none;
}
.footer a:hover { color: var(--accent); }
/* Mobile */
@media (max-width: 600px) {
.header h1 { font-size: 1.5rem; }
.container { padding: 2rem 1rem; }
pre { padding: 1rem; font-size: 0.75rem; }
}
< / style >
< / head >
< body >
< div class = "container" >
< div class = "header" >
< h1 > Quickstart< / h1 >
< div class = "subtitle" > from zero to your first automated PR< / div >
< a class = "back" href = "/" > ← disinto.ai< / a >
< / div >
< div class = "doc-nav" >
< a href = "/docs/quickstart" class = "active" > Quickstart< / a >
< a href = "/docs/architecture" > Architecture< / a >
< a href = "/dashboard" > Dashboard< / a >
< / div >
< div class = "prereqs" >
< div class = "label" > Prerequisites< / div >
< ul >
< li > < strong > A VPS or server< / strong > — 8 GB RAM minimum (Ubuntu/Debian recommended)< / li >
2026-03-25 16:52:05 +00:00
< li > < strong > Docker + Docker Compose< / strong > — the stack runs as containers (Forgejo + Woodpecker CI included)< / li >
2026-03-21 14:43:19 +00:00
< li > < strong > An Anthropic API key< / strong > — with the < code > claude< / code > CLI installed and authenticated< / li >
< li > < strong > tmux< / strong > — for persistent dev sessions< / li >
< / ul >
< / div >
2026-03-25 16:59:36 +00:00
<!-- Step 1: Clone disinto -->
2026-03-21 14:43:19 +00:00
< div class = "section" >
< div class = "step-header" >
< span class = "step-num" > 1< / span >
2026-03-25 16:59:36 +00:00
Clone disinto
2026-03-21 14:43:19 +00:00
< / div >
2026-03-25 16:59:36 +00:00
< p > Clone the factory onto your server and configure your API key.< / p >
2026-03-25 16:52:05 +00:00
< pre > < code > git clone https://codeberg.org/johba/disinto.git ~/disinto
2026-03-21 14:43:19 +00:00
cd ~/disinto
2026-03-25 16:52:05 +00:00
cp .env.example .env
< span class = "comment" > # Edit .env with your Anthropic API key< / span > < / code > < / pre >
2026-03-21 14:43:19 +00:00
< / div >
<!-- Step 2: Initialize your project -->
< div class = "section" >
< div class = "step-header" >
< span class = "step-num" > 2< / span >
Initialize your project
< / div >
2026-03-25 16:59:36 +00:00
< p > < code > disinto init< / code > starts the full stack (Forgejo + Woodpecker CI), creates your repo, clones it locally, generates the project config, adds labels, and installs cron jobs — all in one command.< / p >
< pre > < code > bin/disinto init user/your-project< / code > < / pre >
< p > Use < code > disinto up< / code > / < code > disinto down< / code > later to restart or stop the stack.< / p >
2026-03-21 14:43:19 +00:00
< div class = "expected" >
< div class = "label" > Expected output< / div >
< code > === disinto init ===
Project: you/your-project
Name: your-project
fix: Replace Codeberg dependency with local Forgejo instance (#611)
- Add setup_forge() to bin/disinto: provisions Forgejo via Docker,
creates admin + bot users (dev-bot, review-bot), generates API
tokens, creates repo, and pushes code — all automated
- Rename env vars: CODEBERG_TOKEN→FORGE_TOKEN, REVIEW_BOT_TOKEN→
FORGE_REVIEW_TOKEN, CODEBERG_REPO→FORGE_REPO, CODEBERG_API→
FORGE_API, CODEBERG_WEB→FORGE_WEB, CODEBERG_BOT_USERNAMES→
FORGE_BOT_USERNAMES (with backwards-compat fallbacks)
- Rename API helpers: codeberg_api()→forge_api(), codeberg_api_all()
→forge_api_all() (with compat aliases)
- Add forge_url field to project TOML; load-project.sh derives
FORGE_API/FORGE_WEB from forge_url + repo
- Update parse_repo_slug() to accept any host URL, not just codeberg
- Forgejo data stored under ~/.disinto/forgejo/ (not in factory repo)
- Update all 58 files: agent scripts, formulas, docs, site HTML
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 16:57:12 +00:00
Cloning: http://localhost:3000/you/your-project.git -> /home/you/your-project
2026-03-21 14:43:19 +00:00
Branch: main
Created: /home/you/disinto/projects/your-project.toml
Creating labels on you/your-project...
+ backlog
+ in-progress
+ blocked
+ tech-debt
+ underspecified
+ vision
+ action
Created: /home/you/your-project/VISION.md
Cron entries installed
Done. Project your-project is ready.< / code >
< / div >
< p > Optional flags:< / p >
< ul >
< li > < code > --branch main< / code > — set the primary branch (auto-detected by default)< / li >
< li > < code > --ci-id 3< / code > — Woodpecker CI repo ID (0 = no CI)< / li >
< li > < code > --repo-root /path/to/clone< / code > — custom clone location< / li >
< li > < code > --yes< / code > — skip confirmation prompts< / li >
< / ul >
< / div >
<!-- Step 3: Prepare the repo -->
< div class = "section" >
< div class = "step-header" >
< span class = "step-num" > 3< / span >
Prepare your repo
< / div >
2026-03-25 16:52:05 +00:00
< p > Your project needs two things before agents can work on it:< / p >
2026-03-21 14:43:19 +00:00
< ol >
< li > < strong > A CI pipeline< / strong > — at least one < code > .woodpecker/*.yml< / code > file. Agents wait for CI before reviewing or merging.< / li >
< li > < strong > A CLAUDE.md< / strong > — project context that agents read before every task. Describe your tech stack, how to build/test, coding conventions, and directory layout.< / li >
< / ol >
2026-03-25 16:52:05 +00:00
< p > Branch protection and the review bot are pre-configured on the built-in Forgejo. If you're connecting to an external forge, set those up manually.< / p >
2026-03-21 14:43:19 +00:00
< pre > < code > < span class = "comment" > # Create CLAUDE.md in your project< / span >
cat > ~/your-project/CLAUDE.md < < 'EOF'
# Your Project
## Tech stack
- Node.js, React, PostgreSQL
## How to build and test
npm install & & npm test
## Conventions
- Use TypeScript, ESLint, Prettier
- Tests in __tests__/ directories
EOF
cd ~/your-project
git add CLAUDE.md & & git commit -m "Add CLAUDE.md for agent context"
git push< / code > < / pre >
< / div >
<!-- Step 4: File your first issue -->
< div class = "section" >
< div class = "step-header" >
< span class = "step-num" > 4< / span >
File your first issue
< / div >
fix: Replace Codeberg dependency with local Forgejo instance (#611)
- Add setup_forge() to bin/disinto: provisions Forgejo via Docker,
creates admin + bot users (dev-bot, review-bot), generates API
tokens, creates repo, and pushes code — all automated
- Rename env vars: CODEBERG_TOKEN→FORGE_TOKEN, REVIEW_BOT_TOKEN→
FORGE_REVIEW_TOKEN, CODEBERG_REPO→FORGE_REPO, CODEBERG_API→
FORGE_API, CODEBERG_WEB→FORGE_WEB, CODEBERG_BOT_USERNAMES→
FORGE_BOT_USERNAMES (with backwards-compat fallbacks)
- Rename API helpers: codeberg_api()→forge_api(), codeberg_api_all()
→forge_api_all() (with compat aliases)
- Add forge_url field to project TOML; load-project.sh derives
FORGE_API/FORGE_WEB from forge_url + repo
- Update parse_repo_slug() to accept any host URL, not just codeberg
- Forgejo data stored under ~/.disinto/forgejo/ (not in factory repo)
- Update all 58 files: agent scripts, formulas, docs, site HTML
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 16:57:12 +00:00
< p > Create an issue on the forge with the < code > backlog< / code > label. Be specific — the dev-agent works best with clear acceptance criteria.< / p >
2026-03-21 14:43:19 +00:00
< pre > < code > < span class = "comment" > # Title: Add health check endpoint< / span >
< span class = "comment" > # Label: backlog< / span >
< span class = "comment" > # Body:< / span >
## Problem
The app has no health check endpoint for monitoring.
## Approach
Add a GET /health route that returns { "status": "ok" }.
## Acceptance criteria
- [ ] GET /health returns 200 with JSON body
- [ ] Response includes uptime in seconds
- [ ] Test covers the new endpoint< / code > < / pre >
< p > That's it. The factory takes over from here.< / p >
< / div >
<!-- Step 5: Watch the lifecycle -->
< div class = "section" >
< div class = "step-header" >
< span class = "step-num" > 5< / span >
Watch the lifecycle
< / div >
< p > Within minutes, the agents start working. Here's what happens:< / p >
< div class = "lifecycle" >
< span class = "step" > issue filed< / span >
< span class = "arrow" > → < / span >
< span class = "step" > dev-agent picks it up< / span >
< span class = "arrow" > → < / span >
< span class = "step" > PR opened< / span >
< span class = "arrow" > → < / span >
< span class = "step" > CI runs< / span >
< span class = "arrow" > → < / span >
< span class = "step" > review-agent reviews< / span >
< span class = "arrow" > → < / span >
< span class = "step" > merged< / span >
< / div >
< p > Monitor progress with:< / p >
< pre > < code > < span class = "comment" > # Check factory status< / span >
bin/disinto status
< span class = "comment" > # Watch the dev-agent log< / span >
tail -f /tmp/dev-agent.log
< span class = "comment" > # Watch the review log< / span >
tail -f /tmp/review.log< / code > < / pre >
< div class = "expected" >
< div class = "label" > Expected timeline< / div >
< code > ~2 min dev-poll finds the issue, claims it
~5 min dev-agent opens a PR with the implementation
~2 min CI runs (Woodpecker)
~2 min review-agent approves or requests changes
~1 min PR merges, issue closes automatically< / code >
< / div >
< p > If the review-agent requests changes, the dev-agent addresses them automatically. The loop repeats until the PR is approved and merged.< / p >
< / div >
<!-- Step 6: Verify -->
< div class = "section" >
< div class = "step-header" >
< span class = "step-num" > 6< / span >
Verify everything works
< / div >
< pre > < code > < span class = "comment" > # Factory status — shows active sessions, backlog depth, open PRs< / span >
bin/disinto status
< span class = "comment" > # Check your repo — the PR should be merged< / span >
cd ~/your-project
git pull
git log --oneline -5< / code > < / pre >
< p > You should see a merge commit with the dev-agent's implementation. The issue is closed, the branch is deleted.< / p >
< / div >
<!-- What's next -->
< div class = "section" >
< h2 > What's next< / h2 >
< p > Now that the factory is running:< / p >
< ul >
< li > < strong > Write VISION.md< / strong > — describe where the project is headed. The planner reads it weekly and creates issues to close gaps.< / li >
< li > < strong > File more issues< / strong > — the dev-agent processes them one at a time, in order. Use < code > ## Dependencies< / code > sections to control sequencing.< / li >
< li > < strong > Watch the dashboard< / strong > — < a href = "/dashboard" > disinto.ai/dashboard< / a > shows live factory metrics.< / li >
< li > < strong > Read the architecture< / strong > — < a href = "/docs/architecture" > understand how the agents work together< / a > .< / li >
< / ul >
< / div >
< div class = "footer" >
< a href = "/" > ← disinto.ai< / a > ·
< a href = "/docs/architecture" > Architecture< / a > ·
fix: Replace Codeberg dependency with local Forgejo instance (#611)
- Add setup_forge() to bin/disinto: provisions Forgejo via Docker,
creates admin + bot users (dev-bot, review-bot), generates API
tokens, creates repo, and pushes code — all automated
- Rename env vars: CODEBERG_TOKEN→FORGE_TOKEN, REVIEW_BOT_TOKEN→
FORGE_REVIEW_TOKEN, CODEBERG_REPO→FORGE_REPO, CODEBERG_API→
FORGE_API, CODEBERG_WEB→FORGE_WEB, CODEBERG_BOT_USERNAMES→
FORGE_BOT_USERNAMES (with backwards-compat fallbacks)
- Rename API helpers: codeberg_api()→forge_api(), codeberg_api_all()
→forge_api_all() (with compat aliases)
- Add forge_url field to project TOML; load-project.sh derives
FORGE_API/FORGE_WEB from forge_url + repo
- Update parse_repo_slug() to accept any host URL, not just codeberg
- Forgejo data stored under ~/.disinto/forgejo/ (not in factory repo)
- Update all 58 files: agent scripts, formulas, docs, site HTML
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 16:57:12 +00:00
< a href = "http://localhost:3000/johba/disinto" > Source< / a >
2026-03-21 14:43:19 +00:00
< / div >
< / div >
< / body >
< / html >
