본문으로 건너뛰기

시작하기

⛔ 이 문서의 모든 줄은 실물을 눌러 얻었다(2026-09-22). 수를 인용하지 말고 「재는 명령」으로 그때 다시 재라. 🔲 안 잰 칸은 「안 쟀다」로 남겼다 — 빈 기계에서 처음부터 끝까지 돌려 본 적은 «없다».

이것이 무엇인가​

말 한 줄에 눈·손·기억이 한꺼번에 도는 자기치유 코딩 하니스. 목표를 문서로 받아 격리된 워크트리에서 구현하고, 게이트를 돌리고, 무인 리뷰를 거쳐 병합까지 간다. 사람은 시스템이 못 할 때만 불린다.

0. 필요한 것​

bun >= 1.3.5        package.json 의 engines 가 그렇게 말한다
git                 설치기가 없으면 rc=127 로 «이름을 대며» 멈춘다
LLM 자격 하나       구독(OAuth) 또는 API 키 — 어느 쪽이든 된다

⚠️ bun 이 없으면 설치기가 조용히 실패하지 않는다 — ⛔ required command missing: <이름> 으로 멈춘다.

1. 설치​

curl -fsSL <공개 URL>/install.sh | bash        # ⬜ 공개 URL 미정

Windows(PowerShell)는 install.ps1.

📏 설치기가 «실제로» 하는 일:

PREFIX  기본 $HOME/.elanous   (--prefix 또는 ELANOUS_INSTALL_PREFIX 로 바꾼다)
심는 것 $PREFIX/bin/elanous   ⊕ 셸 프로필에 PATH 한 줄
끝 줄   Installed elanous <버전> at <PREFIX>/bin/elanous

⚠️ 같은 프로필에 다른 PREFIX 가 이미 있으면 덮지 않고 멈춘다 (⛔ PATH block already points to a different installation prefix).

2. 상태를 먼저 본다​

elanous doctor

📏 자격이 하나도 없어도 돈다 — 이 창이 「진짜 0」(HOME·자격 캐시 둘 다 빈 디렉토리)에서 쟀다:

rc = 0 · 164줄 · resolved 0건 · unresolved 41
잠긴 능력을 전부 「<능력> — unlock with <KEY>」 로 이름을 댄다

⇒ 무엇이 없어서 무엇이 안 되는지가 화면에 나온다. 추측하지 않아도 된다.

3. 자격을 붙인다​

elanous setup                    # 무엇이 빠졌는지 짚어 주고, 물어본 뒤 고쳐 준다
elanous login openai-codex       # 구독(device-code)으로 로그인
codex login                    # Codex CLI 쪽 로그인 (app-server 통합용)

⚠️ elanous setup --non-interactive 는 보고만 한다 — 묻지도 쓰지도 않는다.

📏 사람 손 횟수 — 현재 5번: ⑴ 설치 ⑵ elanous login openai-codex ⑶ elanous config set llm.provider openai-codex ⑷ codex login ⑸ 첫 골. 목표는 3번 이하이고 줄일 후보는 ⑶ 이다. 🔲 이 수는 «명령을 센» 값이다 — 빈 기계에서 실제로 세지 않았다.

4. 첫 골​

elanous harness say "이 파일의 테스트를 붙여라"

이 한 줄 뒤로는 사람 손이 없다. 하니스가 골 문서를 쓰고, 격리 워크트리를 만들고, 자식 에이전트를 띄우고, 게이트를 돌리고, 무인 리뷰를 거쳐 병합한다.

골 문서를 이미 썼다면:

elanous harness ask docs/goals/<내-ASK>.md

⛔ 포그라운드로 띄우면 호출자의 타임아웃이 자식을 죽인다. 오래 걸리는 발사는 배경으로 돌려라.

5. 무슨 일이 있었는지 본다​

elanous logs --category self-implement        # 그 런이 남긴 관측
elanous harness worktrees                     # 워크트리와 소유자
elanous self run-ledger <runId>               # 원장 — 단계·결과·분류

런마다 남는 것: 골 문서 · 워크트리와 브랜치 · 원장 한 줄 · 구조화 로그. 그래서 실패한 런도 «나중에 읽을 수 있다».

알아 둘 것 둘​

세계를 보는 눈은 일부 «빌린 것»이다​

웹·브라우저 시야는 외부 서비스에 얹혀 있다(firecrawl · omni-crawl 안의 grok · aside · CDP). catalog/resources.yaml 이 항목마다 「없으면 무엇이 안 되나」 를 적는다. ⚠️ 다만 자격이 필요한 27개 중 20개는 그 칸이 비어 있다 — 비어 있으면 「안 잰 것」이다.

다른 저장소에는 아직 못 쓴다​

하니스가 여러 자리에서 이 저장소를 전제한다 — 기본 정합 게이트가 bun bin/elanous.mjs --help 를 돌리는데 남의 프로젝트엔 그것이 없다.