___ ____ ___ / _ \/ ___||__ \ / /_\/\___ \ / / / /_\ \___) |/ / \____/|____//_/ v3.4.3
AI Token Optimizer for Claude Code
In large codebases, repeated exploration wastes tokens and slows Claude down.
ato pre-curates your architecture so Claude starts every session with full context — automatically.
🧠 Code intelligence graph — Claude understands your architecture instantly · 🔗 Auto-wired hooks — zero manual steps · 💾 Persistent memory — survives context resets
- The Problem
- Install
- Quick Start
- Why Not Just a CLAUDE.md?
- What ato init does
- Persistent Memory
- How It Works
- Platform Support
- ato check Dashboard
- Commands Reference
- Token Savings
- License
Claude Code navigates your codebase on demand — reading files, grepping symbols, listing directories as needed. In small projects this works well. In larger ones (~30,000+ lines), it gets expensive:
- A single grep can return thousands of results; Claude reads many files to triangulate the right context
- Each session re-explores the same architecture from scratch
- Context resets wipe everything: decisions made, work in progress, discovered gotchas
Anthropic's own documentation recommends "curation at the harness layer" for large codebases. That's exactly what ato does: it pre-builds your architecture map, critical paths, and git-derived coupling data — and injects it before every session via hooks.
| Without ato | With ato | |
|---|---|---|
| Architecture knowledge | ❌ Re-explored each session | ✅ Pre-mapped at ato init |
| Coupling information | ❌ Hidden in git history | ✅ Auto-extracted and summarized |
| Session setup | Manual copy-paste | Fully automatic via hooks |
| Context reset | ❌ Start over from scratch | ✅ DECISIONS.md auto-loaded |
| Multi-machine sync | ❌ Manual | ✅ Auto git commit after every session |
| Stays current | ❌ Manual maintenance | ✅ Auto-updated via Stop hook |
curl -fsSL https://raw.githubusercontent.com/aarjang/ato/main/install.sh | bash
source ~/.zshrc # or ~/.bashrcWorks on macOS (Terminal + Claude Code App), Linux, and Windows via WSL2. See Platform Support for Windows setup.
# Step 1 — once per project
cd ~/your-project
ato init
# Step 2 — every session (Terminal or Desktop App)
claudeThat's it. No copy-paste. No manual steps. Just open Claude and type.
Working from another machine? Run
git pull— your context, memory, and stats sync automatically.
You can write a CLAUDE.md by hand and @import specific files. For small projects, or if you're willing to maintain it manually, that's a perfectly valid approach and ato may not be necessary.
ato adds value when:
Manual CLAUDE.md |
ato | |
|---|---|---|
| Architecture map | Written once, drifts over time | Auto-generated from directory structure |
| Coupling information | Requires reading git history manually | Auto-extracted from 90 days of commits |
| Stays current | Only if you remember to update it | Auto-updated after every session |
| Persistent memory | Manual | ato mem + auto-committed DECISIONS.md |
| Setup time | 30–60 min per project | ~30 seconds |
The coupling map is the hardest part to maintain manually: it captures which files always change together — derived from actual git history. This is the kind of signal a developer builds up over months but rarely writes down explicitly.
Honest take: For projects under ~10,000 lines, a well-written
CLAUDE.mdmay be all you need. ato is most valuable for larger codebases and developers who prefer automation over manual curation.
Scans your project and builds a structured map Claude reads before every session:
## Architecture
controllers/ 3 files AuthController, UserController, OrderController
services/ 5 files AuthService, PaymentService, EmailService ...
models/ 4 files User, Order, Product, Session
## Critical path (read these first)
12 src/services/auth.ts
exports: authenticateUser · validateToken · hashPassword
9 src/lib/db.ts
exports: getConnection · query · transaction
## Coupling map (change these together)
auth.service.ts ↔ auth.controller.ts 18 commits
user.model.ts ↔ user.service.ts 11 commitsClaude reads this and knows your architecture without opening a single file.
The graph is built from:
- Architecture layers — detected from directory names and filename patterns
- Critical path — files most imported across the project, with their export surface
- Coupling map — pairs that always change together, from the last 90 days of git history
| Hook | Fires | Action |
|---|---|---|
UserPromptSubmit |
Before every session | ato go --quiet → generates focus file |
Stop |
After every session | ato sync → updates CONTEXT.md + auto-commits |
Hook commands use the absolute path to the ato binary, so they work correctly in both the Claude Code CLI and the Desktop App (which may not source your shell profile).
Tells Claude to read .ato_focus_auto.md at the start of every session — automatically, with no user action required.
A separate file for decisions, in-progress work, and gotchas. Committed to git. Loaded every session. See Persistent Memory.
The problem: Claude Code context resets wipe everything — decisions made, work in progress, gotchas you discovered. You re-explain from scratch every time.
The solution: DECISIONS.md — committed to git, auto-synced, auto-loaded at every session start.
# Log a decision
ato mem "decided to use Redis instead of Postgres for session storage"
# Track work in progress
ato mem --wip "auth middleware — 70% done, next: token refresh"
# Add a gotcha
ato mem --warn "never touch bin/legacy-migrate.sh — breaks prod silently"
# Mark WIP as complete (removes it)
ato mem --done "auth middleware"
# View everything
ato mem --list
# Start fresh
ato mem --clearAfter the above, your DECISIONS.md looks like:
## Active work
- [ ] auth middleware — 70% done, next: token refresh
## Decisions
- 2026-06-28 decided to use Redis instead of Postgres for session storage
## Watch out
- never touch bin/legacy-migrate.sh — breaks prod silentlyAfter any context reset, Claude reads this and continues exactly where you left off — no re-explaining needed.
┌─────────────────────────────────────────────────────────────┐
│ ato init (once per project) │
│ │
│ Scan → import graph → git co-change analysis │
│ ↓ │
│ CONTEXT.md ← architecture + critical path + coupling │
│ DECISIONS.md ← persistent memory (starts empty) │
│ CLAUDE.md ← standing instruction: read focus file │
│ settings.json ← UserPromptSubmit + Stop hooks wired │
└──────────────────────────┬──────────────────────────────────┘
│
┌──────────────────────────▼──────────────────────────────────┐
│ Open Claude (CLI or Desktop App — every session) │
│ │
│ UserPromptSubmit hook fires │
│ ↓ │
│ ato go --quiet → builds .ato_focus_auto.md │
│ contains: CONTEXT.md + DECISIONS.md + file contents │
│ ↓ │
│ CLAUDE.md: "read .ato_focus_auto.md immediately" │
│ ↓ │
│ Claude starts with full context. Zero exploration. │
└──────────────────────────┬──────────────────────────────────┘
│
┌──────────────────────────▼──────────────────────────────────┐
│ Session ends │
│ │
│ Stop hook → ato sync │
│ → CONTEXT.md updated with latest git activity │
│ → git commit "chore: auto-sync ato context [skip ci]" │
│ → session lock cleared for next session │
└─────────────────────────────────────────────────────────────┘
Watch live activity:
tail -f ~/.ato/run.log| Platform | CLI | Desktop App | Notes |
|---|---|---|---|
| macOS (Terminal) | ✅ Full | ✅ Full | Primary platform |
| macOS (Claude Code App) | ✅ Full | ✅ Full | Hooks use absolute path — works even when app doesn't source shell profile |
| Linux | ✅ Full | ✅ Full | |
| Windows + WSL2 | ✅ Full | ✅ Full | Hooks use wsl bash -lc so Windows Claude Code App can call them |
| Windows + Git Bash | ❌ | Core commands work; hooks unreliable | |
| Windows (native) | ❌ | ❌ | Bash required |
ato works wherever Claude Code runs. The rule: if it reads .claude/settings.json and fires hooks, ato works automatically.
| Environment | Works? | Notes |
|---|---|---|
| VS Code + Claude Code extension | ✅ | Same hook system — no extra setup |
| JetBrains + Claude Code extension | ✅ | Same hook system — no extra setup |
| Cursor | ❌ | Not Claude Code — different hook system |
| GitHub Copilot | ❌ | Different product entirely |
| Windsurf | ❌ | Different product entirely |
No extra steps. ato init stores the absolute path to the ato binary in hook commands, so the Desktop App can find it even without sourcing your shell profile:
{
"hooks": {
"UserPromptSubmit": [{"hooks": [{"command": "/Users/you/bin/ato go --quiet"}]}],
"Stop": [{"hooks": [{"command": "/Users/you/bin/ato sync"}]}]
}
}# Step 1 — Install WSL2 (PowerShell as Administrator)
wsl --install
# Step 2 — Inside WSL terminal, install ato
curl -fsSL https://raw.githubusercontent.com/aarjang/ato/main/install.sh | bash
source ~/.bashrc
# Step 3 — Work on projects via Windows filesystem path
# ✅ Do this: accessible to both WSL and Claude Code Desktop
cd /mnt/c/Users/$USER/projects/my-project
ato init
# ❌ Not this: Claude Code Desktop can't open WSL filesystem paths
# cd ~/projects/my-projectato init automatically detects WSL and sets hooks to:
{"command": "wsl bash -lc 'ato go --quiet'"}
{"command": "wsl bash -lc 'ato sync'"}Claude Code Desktop for Windows calls these and WSL executes them — fully transparent.
Environment
──────────────────────────────────────────────
Platform macOS
ato binary /Users/you/bin/ato
Hook command /Users/you/bin/ato go --quiet
╔══════════════════════════════════════════════════╗
║ ATO v3.4.3 — my-project ║
╚══════════════════════════════════════════════════╝
Context
──────────────────────────────────────────────
✓ CONTEXT.md 95 lines ~570 lean ✓
✓ CLAUDE.md 18 lines ~108 lean ✓
✓ DECISIONS.md 14 lines ~84 lean ✓
✓ Auto-sync active (Stop hook)
✓ Auto-focus active (UserPromptSubmit hook)
✓ Focus file ~2k
Available for work: ~166k / ~200k tokens (83% free)
Session
──────────────────────────────────────────────
██████░░░░░░░░░░░░░░░░░░ 26% safe to continue
(estimate — for exact: /context inside Claude Code)
Environment
──────────────────────────────────────────────
Platform macOS
ato binary /Users/you/bin/ato
Hook command /Users/you/bin/ato go --quiet
Git
──────────────────────────────────────────────
Branch main
Status clean
Last commit "feat: add payment integration" (2 hours ago)
Savings (estimate — based on project size vs. focus file size)
──────────────────────────────────────────────
Sessions 47
Saved ~820k tokens ≈ $2.46
Last session 2026-06-28
| Command | Description |
|---|---|
ato init |
Scan project, build code graph, wire hooks, create all files |
ato mem "decision" |
Log a decision that survives context reset |
ato mem --wip "text" |
Track work in progress |
ato mem --done "text" |
Remove completed WIP item |
ato mem --warn "text" |
Add a gotcha / watch-out |
ato mem --list |
Show all memory |
ato mem --clear |
Reset all memory (with confirmation) |
ato note "text" |
Append a quick note to CONTEXT.md |
ato go |
Manually rebuild focus file (runs automatically on session start) |
ato go auth |
Focus on a specific topic |
ato check |
Full health dashboard: context + session + environment + savings |
ato audit |
Token budget breakdown per section |
ato audit --reset |
Reset session stats |
ato update |
Self-update to latest version |
⚙️ Power options
ato go --budget 40k # trim scope to fit Claude Pro token limits
ato audit --scope "*.ts" # token cost of a specific file set
ato mcp install # register ato as MCP server in Claude Code
ato task add "text" # optional task tracking
ato task done 1 # mark task complete
tail -f ~/.ato/run.log # watch auto-focus activity liveClaude Code reads files on demand, not all at once at session start — so there's no single "startup cost" to measure against. The real savings come from reducing repeated exploration across sessions:
- Less re-exploration — architecture in
CONTEXT.mdmeans Claude doesn't grep the same structure session after session - Less triangulation — the coupling map and critical paths reduce how many files Claude reads to answer a question
- Less context-reset overhead —
DECISIONS.mdmeans you don't re-explain decisions after every compaction
To measure your own savings: run /context inside Claude Code at the start of a session with and without ato loaded. The difference is your actual number.
Stats are stored locally:
.ato-stats.json— this project~/.ato/stats.json— all projects (aggregate)
Note: The token estimate in
ato checkuses your project's line count as a rough proxy — not a measurement of actual session consumption. For precise numbers, use/contextinside Claude Code.
Reset anytime with ato audit --reset.
MIT © Arjang Mousavi
- مشکل
- نصب
- شروع سریع
- چرا فقط CLAUDE.md کافی نیست؟
- ato init چه میکنه
- حافظه دائمی
- چطور کار میکنه
- پشتیبانی پلتفرمها
- داشبورد ato check
- مرجع دستورات
- صرفهجویی توکن
- مجوز
Claude Code codebase رو on-demand میگرده — فایل میخونه، grep میزنه، دایرکتوری لیست میکنه. تو پروژههای کوچیک خوب کار میکنه. تو پروژههای بزرگتر (~۳۰٬۰۰۰ خط به بالا) گرون میشه:
- یه grep ممکنه هزاران نتیجه برگردونه؛ Claude فایلهای زیادی میخونه تا context رو پیدا کنه
- هر session دوباره همون معماری رو از صفر explore میکنه
- context reset همه چیز رو پاک میکنه: تصمیمات، کارهای نیمهتمام، هشدارهایی که پیدا کردی
مستندات Anthropic برای codebase های بزرگ «curation در لایه harness» رو توصیه میکنه. دقیقاً همین کاریه که ato میکنه: نقشه معماری، critical path، و اطلاعات coupling از git history رو میسازه و قبل از هر session inject میکنه.
| بدون ato | با ato | |
|---|---|---|
| دانش معماری | ❌ هر session دوباره explore | ✅ یه بار map شده در ato init |
| اطلاعات coupling | ❌ پنهان در git history | ✅ خودکار استخراج و خلاصهشده |
| تنظیم session | copy-paste دستی | کاملاً خودکار با hooks |
| بعد از context reset | ❌ از صفر شروع | ✅ DECISIONS.md خودکار لود |
| sync چند دستگاه | ❌ دستی | ✅ auto git commit بعد از هر session |
| بهروز میمونه | ❌ نگهداری دستی | ✅ auto-update با Stop hook |
curl -fsSL https://raw.githubusercontent.com/aarjang/ato/main/install.sh | bash
source ~/.zshrc # یا ~/.bashrcروی macOS (Terminal + Desktop App)، Linux، و Windows از طریق WSL2 کار میکنه. برای راهاندازی ویندوز، پشتیبانی پلتفرمها رو ببین.
# مرحله ۱ — یه بار در هر پروژه
cd ~/your-project
ato init
# مرحله ۲ — هر session (Terminal یا Desktop App)
claudeهمین. بدون copy-paste. بدون قدم دستی. فقط Claude رو باز کن و تایپ کن.
از دستگاه دیگهای کار میکنی؟
git pullبزن — context، memory، و stats خودکار sync میشن.
میتونی یه CLAUDE.md دستی بنویسی و فایلهای خاص رو @import کنی. برای پروژههای کوچیک، یا اگه حاضری دستی نگهداریش کنی، این کاملاً درسته و ato لازم نیست.
ato کجا ارزش داره:
CLAUDE.md دستی |
ato | |
|---|---|---|
| نقشه معماری | یه بار نوشته، با زمان کهنه میشه | خودکار از ساختار directory |
| اطلاعات coupling | نیاز به خوندن git history دستی | خودکار از ۹۰ روز commit |
| بهروز میمونه | فقط اگه یادت بمونه | بعد از هر session خودکار |
| حافظه دائمی | دستی | ato mem + DECISIONS.md auto-commit |
| زمان راهاندازی | ۳۰–۶۰ دقیقه | ~۳۰ ثانیه |
coupling map سختترین چیزیه که دستی نگه داری: نشون میده کدوم فایلها همیشه با هم تغییر میکنن — بر اساس git history واقعی. این نوع اطلاعاتیه که یه developer طی ماهها جمع میکنه ولی معمولاً هیچوقت نمینویسه.
صادقانه: برای پروژههای زیر ~۱۰٬۰۰۰ خط، یه
CLAUDE.mdخوب ممکنه کافی باشه. ato بیشترین ارزش رو برای codebase های بزرگتر و کسایی داره که اتوماسیون رو ترجیح میدن.
پروژه رو اسکن میکنه و یه نقشه ساختاری میسازه که Claude قبل از هر session میخونه:
## Architecture
controllers/ ۳ فایل AuthController, UserController, OrderController
services/ ۵ فایل AuthService, PaymentService, EmailService ...
models/ ۴ فایل User, Order, Product, Session
## Critical path (اول اینا رو بخون)
۱۲ src/services/auth.ts
exports: authenticateUser · validateToken · hashPassword
۹ src/lib/db.ts
exports: getConnection · query · transaction
## Coupling map (اینا رو با هم تغییر بده)
auth.service.ts ↔ auth.controller.ts ۱۸ commit
user.model.ts ↔ user.service.ts ۱۱ commitClaude این رو میخونه و بدون باز کردن یه فایل معماری رو میفهمه.
Graph از اینا ساخته میشه:
- Architecture layers — از نام دایرکتوریها و patternهای فایلها
- Critical path — فایلهایی که بیشترین import رو دارن + export surface
- Coupling map — جفتهایی که همیشه با هم تغییر میکنن (۹۰ روز گذشته git)
| Hook | کِی میزنه | عمل |
|---|---|---|
UserPromptSubmit |
قبل از هر session | ato go --quiet → focus file میسازه |
Stop |
بعد از هر session | ato sync → CONTEXT.md آپدیت + auto-commit |
دستورات hook از مسیر مطلق binary ato استفاده میکنن — در هر دو CLI و Desktop App کار میکنه، حتی اگه app محیط shell رو source نکنه.
به Claude میگه اول هر session .ato_focus_auto.md رو بخونه — خودکار، بدون هیچ اقدامی از طرف کاربر.
یه فایل مجزا برای تصمیمات، کارهای در جریان، و هشدارها. Commit میشه. هر session لود میشه. ادامه در حافظه دائمی.
مشکل: context reset در Claude Code همه چیز رو پاک میکنه — تصمیمات، کارهای نیمهتمام، مشکلاتی که پیدا کردی. هر بار از صفر توضیح میدی.
راهحل: DECISIONS.md — commit شده در git، خودکار sync، اول هر session لود میشه.
# ثبت تصمیم
ato mem "تصمیم گرفتیم Redis بجای Postgres برای session storage استفاده کنیم"
# ردیابی کار در جریان
ato mem --wip "auth middleware — ۷۰٪ تموم، بعدی: token refresh"
# اضافه کردن هشدار
ato mem --warn "bin/legacy-migrate.sh رو دست نزن — prod رو خاموش میکنه"
# تموم کردن WIP (حذف میشه)
ato mem --done "auth middleware"
# نمایش همه
ato mem --list
# پاک کردن همه
ato mem --clearDECISIONS.md بعد از دستورات بالا:
## Active work
- [ ] auth middleware — ۷۰٪ تموم، بعدی: token refresh
## Decisions
- ۱۴۰۵-۰۴-۰۷ Redis بجای Postgres برای session storage
## Watch out
- bin/legacy-migrate.sh رو دست نزن — prod رو خاموش میکنهبعد از هر context reset، Claude این رو میخونه و دقیقاً از همون جا ادامه میده.
┌─────────────────────────────────────────────────────────────┐
│ ato init (یه بار در هر پروژه) │
│ │
│ اسکن → import graph → آنالیز git co-change │
│ ↓ │
│ CONTEXT.md ← معماری + critical path + coupling │
│ DECISIONS.md ← حافظه دائمی (اول خالی) │
│ CLAUDE.md ← دستور: focus file رو بخون │
│ settings.json ← هوکهای UserPromptSubmit + Stop │
└──────────────────────────┬──────────────────────────────────┘
│
┌──────────────────────────▼──────────────────────────────────┐
│ باز کردن Claude (CLI یا Desktop App — هر session) │
│ │
│ UserPromptSubmit hook فایر میشه │
│ ↓ │
│ ato go --quiet → .ato_focus_auto.md میسازه │
│ شامل: CONTEXT.md + DECISIONS.md + محتوای فایلها │
│ ↓ │
│ CLAUDE.md: ".ato_focus_auto.md رو فوری بخون" │
│ ↓ │
│ Claude با context کامل شروع میکنه. بدون exploration. │
└──────────────────────────┬──────────────────────────────────┘
│
┌──────────────────────────▼──────────────────────────────────┐
│ پایان session │
│ │
│ Stop hook → ato sync │
│ → CONTEXT.md آپدیت با آخرین فعالیت git │
│ → git commit خودکار │
│ → lock session پاک برای session بعدی │
└─────────────────────────────────────────────────────────────┘
فعالیت auto-focus رو live ببین:
tail -f ~/.ato/run.log| پلتفرم | CLI | Desktop App | توضیح |
|---|---|---|---|
| macOS (Terminal) | ✅ کامل | ✅ کامل | Platform اصلی |
| macOS (Claude Code App) | ✅ کامل | ✅ کامل | Hooks از مسیر مطلق استفاده میکنن |
| Linux | ✅ کامل | ✅ کامل | |
| Windows + WSL2 | ✅ کامل | ✅ کامل | Hooks از wsl bash -lc استفاده میکنن |
| Windows + Git Bash | ❌ | دستورات اصلی کار میکنن؛ hooks نه | |
| Windows (native) | ❌ | ❌ | Bash لازمه |
ato هر جا Claude Code باشه کار میکنه. قانون: اگه .claude/settings.json خونده بشه و hooks فایر بشن، ato خودکار کار میکنه.
| محیط | کار میکنه؟ | توضیح |
|---|---|---|
| VS Code + Claude Code extension | ✅ | همون hook system — نیاز به تنظیم اضافه نیست |
| JetBrains + Claude Code extension | ✅ | همون hook system — نیاز به تنظیم اضافه نیست |
| Cursor | ❌ | Claude Code نیست — hook system متفاوت |
| GitHub Copilot | ❌ | محصول کاملاً متفاوت |
| Windsurf | ❌ | محصول کاملاً متفاوت |
قدم اضافهای لازم نیست. ato init مسیر مطلق binary ato رو در hook ها ذخیره میکنه:
{
"hooks": {
"UserPromptSubmit": [{"hooks": [{"command": "/Users/you/bin/ato go --quiet"}]}],
"Stop": [{"hooks": [{"command": "/Users/you/bin/ato sync"}]}]
}
}# ۱. نصب WSL2 (PowerShell به عنوان Administrator)
wsl --install
# ۲. داخل WSL terminal، نصب ato
curl -fsSL https://raw.githubusercontent.com/aarjang/ato/main/install.sh | bash
source ~/.bashrc
# ۳. روی پروژهها از طریق path ویندوز کار کن
# ✅ درست: هم WSL هم Claude Code Desktop میتونن دسترسی داشته باشن
cd /mnt/c/Users/$USER/projects/my-project
ato init
# ❌ اشتباه: Claude Code Desktop نمیتونه WSL filesystem path رو باز کنه
# cd ~/projects/my-projectato init بهصورت خودکار WSL رو detect میکنه و hooks رو اینطوری مینویسه:
{"command": "wsl bash -lc 'ato go --quiet'"}
{"command": "wsl bash -lc 'ato sync'"}Claude Code Desktop ویندوز اینا رو صدا میزنه و WSL اجراشون میکنه — کاملاً شفاف.
Environment
──────────────────────────────────────────────
Platform macOS
ato binary /Users/you/bin/ato
Hook command /Users/you/bin/ato go --quiet
╔══════════════════════════════════════════════════╗
║ ATO v3.4.3 — my-project ║
╚══════════════════════════════════════════════════╝
Context
──────────────────────────────────────────────
✓ CONTEXT.md ۹۵ خط ~۵۷۰ lean ✓
✓ CLAUDE.md ۱۸ خط ~۱۰۸ lean ✓
✓ DECISIONS.md ۱۴ خط ~۸۴ lean ✓
✓ Auto-sync فعال (Stop hook)
✓ Auto-focus فعال (UserPromptSubmit hook)
✓ Focus file ~۲k
موجود برای کار: ~۱۶۶k / ~۲۰۰k توکن (۸۳٪ آزاد)
Session
──────────────────────────────────────────────
██████░░░░░░░░░░░░░░░░░░ ۲۶٪ ادامه بده
Environment
──────────────────────────────────────────────
Platform macOS
ato binary /Users/you/bin/ato
Hook command /Users/you/bin/ato go --quiet
Git
──────────────────────────────────────────────
Branch main
Status clean
آخرین commit "feat: add payment integration" (۲ ساعت پیش)
صرفهجویی (تخمین)
──────────────────────────────────────────────
Sessions ۴۷
صرفهجویی ~۸۲۰k توکن ≈ $۲.۴۶
آخرین session ۱۴۰۵-۰۴-۰۷
| دستور | توضیح |
|---|---|
ato init |
اسکن پروژه، code graph، وایر hooks، ساخت همه فایلها |
ato mem "decision" |
ثبت تصمیم که context reset رو survive میکنه |
ato mem --wip "text" |
ردیابی کار در جریان |
ato mem --done "text" |
حذف WIP تمومشده |
ato mem --warn "text" |
اضافه کردن هشدار / gotcha |
ato mem --list |
نمایش همه حافظه |
ato mem --clear |
پاک کردن همه حافظه (با تأیید) |
ato note "text" |
اضافه کردن یادداشت سریع به CONTEXT.md |
ato go |
ساخت دستی focus file (خودکار اجرا میشه) |
ato go auth |
focus روی topic مشخص |
ato check |
داشبورد کامل: context + session + environment + savings |
ato audit |
breakdown budget توکن هر بخش |
ato audit --reset |
ریست آمار sessions |
ato update |
آپدیت به آخرین نسخه |
⚙️ گزینههای پیشرفته
ato go --budget 40k # محدود کردن scope برای Claude Pro
ato audit --scope "*.ts" # هزینه توکن یه مجموعه فایل
ato mcp install # ثبت به عنوان MCP server
ato task add "text" # task tracking اختیاری
ato task done 1 # تموم کردن task
tail -f ~/.ato/run.log # مشاهده live فعالیت auto-focusClaude Code فایلها رو on-demand میخونه، نه همه رو اول session — پس یه «هزینه شروع» ثابت قابل اندازهگیری وجود نداره. صرفهجویی واقعی از کاهش exploration تکراری میاد:
- کمتر re-exploration — معماری در
CONTEXT.mdیعنی Claude session به session همون ساختار رو grep نمیکنه - کمتر triangulation — coupling map و critical paths تعداد فایلهایی که Claude میخونه رو کم میکنه
- کمتر context-reset overhead —
DECISIONS.mdیعنی بعد از هر compaction تصمیمات رو دوباره توضیح نمیدی
برای اندازهگیری دقیق: /context رو داخل Claude Code با و بدون ato اجرا کن. فرق همون عدد واقعی توئه.
آمار ذخیره میشه در:
.ato-stats.json— این پروژه~/.ato/stats.json— همه پروژهها
توجه: عدد توکن در
ato checkبر اساس تعداد خطهای پروژهست — نه اندازهگیری واقعی مصرف session. برای عدد دقیق،/contextرو داخل Claude Code استفاده کن.
هر وقت خواستی با ato audit --reset ریست کن.
MIT © Arjang Mousavi