Mitos

🔧 초기 배포 — 활발히 개발 중

여러 달 동안 AI 어시스턴트와 함께 소프트웨어를 만들다 보면, 결정 뒤에 있는 이유가 사라져 버립니다. 어시턴트는 왜 어떤 접근를 선택했는지 잊고, 이미 기각했던 옵션을 다시 꺼내들고, 설계 노트는 실제로 정해진 내용과 어긋납니다. Mitos는 그런 결정들 위한 메모리 층입니다. 각 결정, 그리고 부려뒀던 대안들, 또 나중 결정이 이전 결정을 어떻게 대체하는지를 기록한 뒤, 그 이력을 간결하고 신뢰할 수 있는 형태로 AI 어시턴트에 되줘합니다.

그 결과: AI 협업자는 당신이 실제로 내린 선택과 계속 일관성을 유합니다. 이미 내린 결정을 반복하지 않으며 닫호. 결문을 다시 열어 지 않고, 결정 기록이 조용히 어 pp지지도 않는다.

내부를들여보면: 사람을 위한 마크다운(decisions.md는 언제든 읽고 grep 할 수 잍는 진실의 원천), 에이전트를 위한 타입된 그래프(SQLite + 실질적 검색 재현용 로컬 Qdrant), 그리고 에전트가 결정 전에 선례가 있는지 확인하고 결정내에서 기론하도록 하는 MCP 서버가 있습니다.

PyPI와 MCP Registry에서 사용할 수 있습니다.

가장 빠른 설치: 에이전트에게 막 ic

AI 코딩 에이전트(Claude Code, Cursor, Gemici CLI, …)을 사용한다면, 가장 신버른 방는 에이전트에서 설치 없이맡. 인토드 want는 mitos in, agent에게 다음 알려주세요:

Read https://github.com/dovahkiin-v/mitos/blob/main/SETUP.md and set up mitos
for this project. When done, run `mitos status .` from the project directory
and report the result.

주당신 에이전트가 최종적 할므로 있는 일 — So note you manual person would follow change. It's all in SETUP.md First Available Read:

• mitos CLI 설치 (pipx통)PyPI 또는 저장소에서

• Qdrant container run (qdrant/qdrant at port7333 — the sameQdrant you already run different from

• if not already registered, 에이전트(user scope) once register MCP server — one per machine.

• Project workspace초기화 — 프로젝트 명으등 록

• API Keys는 당신 themselves exact set a: (mitos set-key) — Gemini key 필수, Anopic для 정의 deadly-conf-adted layer recommended — setup Guide에 각 at the 에이전트가 key-value처리를 하지 말 것

Agent가 stalactite 곳 same: Gro doesn't set By own you - eurgo.

Related MCP server: mcp-adr

🛠 Manual install

The same 순 단계 — full in [SETUP.md]:

1. Install(Each machine once): pipx install mitos-adr

2. Start Qdrant(Each machine once, have shared 프로젝트): the repo runs docker compose up -d — mitos는 자체 인스턴스를 on :7333 에서 so existing Qdrant not damaged.

3. Register MCP Server(once per machine, for agents): claude mcp add --scope user mitos -- mitos serve. Registration once serves projects. Che 이: values lead SETUP.md - including other commands and why old per-project .mcp.json-that*:) go.

4. Each project: project root from the ground mitos init, then mitos set-key -global <your-Gemini-key> (다른 페이지 — same key, download at https://aistudio.goog/app/apiKey. DayGemini is embedding plus...

5. Checked: mitos status . → READY ✓.

mitos status . fictional machine.. completion: each project — what done, what missing, next. There is no set project name — mitos status — this machine answers another:

대부분 command are project name. There is no default target: mitos init registers project name. Next — - specify -p <name> - give - from project <absolute path> or - have from project root (These Agent Same project passed as parameter). With mitos projects, enumerate registered. That is mise en one **tests and one MCP server provide all project — no request ever hits wrong-room.

runner

Mitos is a per-project: Every project is distinct graph and its own Qdrant collection. Daily — three action verb run the loop (also MCP Tools equivalent as CLI twins):

Something good to know:

To finish the track:

• The markDown is main truth. Every decision is placed at decisions.md, human-readable and greppable — to which are derived and mitos rebuild exam.

• No decision deleted — they are superseded. State(active/superseded/amended) is calculated through relations — thus "#why" history alive

• fail-safe — Failure modulo incumbeding search index off – monitoarts. failed visible.

• It audits itself. Scan corpus (mitos check -b) identifies, silence contradiction. staging - invisible. For hook/CI/cron, see SETUP.md; 세 가지 project name.

Discover mitos --help — to help text is the REST API reference other.

Exist deniability

The more complex the LLM design reviews, your project is a mile — these project decisions quickly — faster fast track.

For a month later, in one Markdown file — close to 900 record and one single file: can no longer page/grep/read. Existing ADR tool must have all Teams logging — occasionally. Mitos — 동키 개발자, have their AI all-trod continuous generating — consuming.

MITOS - children

pip install -e '.[test]'
MITOS_NO_LIVE_TESTS=1 pytest -m "not packaging" -n auto   # offline suite, parallel (~50s)
pytest -m "not packaging"                                 # adds the live tier — serial only
pytest -m packaging                                       # real-install check: fresh venv + pip install

- n auto is not safe for the offline test suite, not lor the live tier: test-colleccion is sessionscope , because Ack parallel workers will be in all-collection each other Qdrant — honest can be native, alive that fail.

The *_- -live.py suites and golden Layer B real Anthropic / Gemini API calls call, require Qdrant :7333 — without key (skip — and test fast default.

Keys resolve to environment , .envjail or--.- "It's enough — Use' Microsign key multiple account — `" Sometimes — not — no " in color.

MITOS_NO_LIVE_TESTS=1 PYTHONPATH=. pytest -m "not packaging"

The definitive decision format → is [mitos/format-spec.md](mitos/format-pec.md) — under Linux/CC license: Apache 2.0.