demian-cli 1.0.3

package/docs/ko/README.md

@@ -0,0 +1,158 @@
+# Demian TUI
+
+**Demian**은 로컬 터미널에서 사용하는 코딩 에이전트입니다. 프로젝트를
+읽고, 질문에 답하고, 파일을 수정하고, 명령 실행 전 권한을 묻고, 긴 작업을
+`/goal`로 관리하며, 필요하면 `/cowork`로 여러 하위 에이전트를 조율합니다.
+
+[English documentation](../../README.md)
+
+## 빠른 시작
+
+```sh
+npm install -g demian-cli
+cd ~/work/my-project
+demian
+```
+
+TUI에서:
+
+- `p`: provider 선택
+- `m`: model 입력
+- `a`: agent 선택
+- `Enter`: 메시지 전송
+- `y`: 권한 1회 허용
+- `a`: 같은 범위 항상 허용
+- `n` 또는 `Enter`: 거부
+
+첫 질문 예시:
+
+```text
+이 저장소 구조를 요약하고 주요 진입점을 알려줘.
+```
+
+## Provider 설정
+
+Demian은 다음 순서로 설정을 읽습니다.
+
+1. 기본값
+2. `~/.demian/config.json`
+3. `~/.demian/config.jsond`
+4. 작업 디렉터리의 `.demian/config.json`
+5. 작업 디렉터리의 `.demian/config.jsond`
+6. `--config <path>`
+7. `.demian/preferences.json`
+8. CLI 플래그
+
+예시:
+
+```jsonc
+{
+  "defaultProvider": "openai",
+  "providers": {
+    "openai": {
+      "type": "openai-compatible",
+      "baseURL": "https://api.openai.com/v1",
+      "apiKeyEnv": "OPENAI_API_KEY",
+      "model": "gpt-5.5"
+    }
+  }
+}
+```
+
+API key는 공유 설정 파일에 직접 쓰기보다 `apiKeyEnv`를 권장합니다.
+
+## Claude 관련 provider
+
+- `anthropic`: Anthropic API key를 사용하는 직접 API provider입니다.
+- `claudecode`: 로컬 Claude Code 설치와 로그인/구독 경로를 사용하는 외부
+  agent runtime입니다.
+
+예시:
+
+```sh
+demian --provider claudecode --model claude-sonnet-4-6
+```
+
+기본 Claude Code 모델 alias:
+
+- `claude-sonnet-4-6`
+- `claude-opus-4-7`
+
+## Goal Mode
+
+긴 작업은 `/goal`로 시작합니다.
+
+```text
+/goal README를 갱신하고 관련 검증을 통과한 뒤에만 완료해 줘.
+```
+
+유용한 명령:
+
+- `/goal status`
+- `/goal pause`
+- `/goal resume`
+- `/goal clear`
+
+목표 상태는 `.demian/goals/` 아래에 저장됩니다.
+
+## Cowork Mode
+
+여러 관점이 필요한 작업은 `/cowork`를 사용합니다.
+
+```text
+/cowork 한 에이전트는 API 계층을 보고, 다른 에이전트는 UI 흐름을 검토해서 원인을 비교해 줘.
+```
+
+Demian이 main coordinator이고, cowork member들은 제한된 역할의 하위
+에이전트로 실행됩니다.
+
+## Plain CLI
+
+스크립트나 raw Markdown 출력이 필요하면 `demian-plain`을 사용합니다.
+
+```sh
+demian-plain "릴리스 체크리스트를 만들어 줘"
+demian-plain --image screenshot.png "이 UI 문제를 설명해 줘"
+```
+
+## 자주 쓰는 명령
+
+```sh
+demian
+demian --provider openai --model gpt-5.5
+demian --provider claudecode --model claude-sonnet-4-6
+demian --single-agent
+demian --multi-agent
+demian --sandbox read-only
+demian-plain "프로젝트 구조를 요약해 줘"
+```
+
+TUI 내부 명령:
+
+- `/compact`: 오래된 대화 압축
+- `/stop`: 현재 작업 중단
+- `/exit` 또는 `/quit`: 종료
+- `/goal ...`: 검증이 필요한 목표 시작
+- `/cowork ...`: cowork 에이전트 조율
+
+## 저장 위치
+
+- `~/.demian/config.json(d)`: 사용자 설정
+- `.demian/config.json(d)`: 프로젝트 설정
+- `.demian/preferences.json`: workspace별 provider/model 선택
+- `.demian/grants.json`: persistent permission grant
+- `.demian/goals/`: goal 상태
+
+## 문제 해결
+
+TUI가 실행되지 않으면 `demian-plain`을 사용하거나 Node 버전을 확인하세요.
+
+```sh
+node --version
+```
+
+Claude Code가 동작하지 않으면 설치 경로를 확인하세요.
+
+```sh
+~/.local/bin/claude --version
+```

package/media/demian.svg

@@ -0,0 +1,9 @@
+<svg width="128" height="128" viewBox="0 0 128 128" xmlns="http://www.w3.org/2000/svg">
+  <title>Demian sidebar concept 03 - egg silhouette with bird</title>
+  <path d="M25 72c0-35 17-62 39-62s39 27 39 62c0 31-15 50-39 50S25 103 25 72Z" fill="#FFF7D6"/>
+  <path d="M38 62c0-22 12-38 30-38 16 0 26 12 28 30l16 7-16 7c-3 15-14 22-32 22H49c-7 0-11-8-11-28Z" fill="#FACC15" stroke="#111827" stroke-width="4" stroke-linejoin="round"/>
+  <circle cx="74" cy="43" r="6" fill="#111827"/>
+  <path d="M25 79l7-7 7 7 7-7 7 7 7-7 7 7 7-7 7 7 7-7 7 7 7-7 7 7c0 27-17 43-48 43S25 106 25 79Z" fill="#FFF7D6"/>
+  <path d="M25 79l7-7 7 7 7-7 7 7 7-7 7 7 7-7 7 7 7-7 7 7 7-7 7 7" fill="none" stroke="#111827" stroke-width="4" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M109 79c0 27-17 43-48 43S25 106 25 79" fill="none" stroke="#111827" stroke-width="4" stroke-linecap="round"/>
+</svg>

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "demian-cli",
+  "version": "1.0.3",
+  "description": "Local terminal coding agent with TUI, goals, cowork agents, permissions, and provider switching.",
+  "type": "module",
+  "icon": "media/demian.svg",
+  "bin": {
+    "demian": "bin/demian",
+    "demian-cli": "bin/demian-cli.js",
+    "demian-plain": "bin/demian-plain.js"
+  },
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./cli": "./dist/cli.mjs",
+    "./vscode-worker": "./dist/vscode-worker.mjs"
+  },
+  "files": [
+    "architecture.md",
+    "architecture-tui.md",
+    "bin",
+    "dist",
+    "docs",
+    "media",
+    "README.md",
+    "tsconfig.json"
+  ],
+  "scripts": {
+    "build": "esbuild src/index.ts src/tui.ts src/cli.ts src/vscode-worker.ts --bundle --platform=node --format=esm --target=node22 --outdir=dist --out-extension:.js=.mjs --loader:.ts=ts --define:process.env.DEV=\\\"false\\\" --external:@anthropic-ai/claude-agent-sdk-* --external:ink --external:react --external:react-devtools-core --banner:js=\"import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);\"",
+    "prepack": "npm run build",
+    "test": "node --experimental-strip-types --test test/*.test.ts",
+    "smoke": "npm run smoke:tui && npm run smoke:plain",
+    "smoke:tui": "bin/demian --help",
+    "smoke:plain": "bin/demian-plain.js --help"
+  },
+  "engines": {
+    "node": ">=22.18"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "0.3.143",
+    "@anthropic-ai/sdk": "0.96.0",
+    "chalk": "^5.4.1",
+    "cli-highlight": "^2.1.11",
+    "highlight.js": "^11.11.1",
+    "ink": "^5.0.1",
+    "marked": "^15.0.7",
+    "react": "^18.3.1",
+    "slice-ansi": "^7.1.0",
+    "string-width": "^7.2.0",
+    "wrap-ansi": "^9.0.0"
+  },
+  "devDependencies": {
+    "esbuild": "^0.24.0"
+  },
+  "keywords": [
+    "agent",
+    "coding-agent",
+    "openai-compatible",
+    "cli"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pydemia/demian.git",
+    "directory": "nodejs"
+  },
+  "author": "pydemia",
+  "license": "Apache-2.0"
+}

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "allowImportingTsExtensions": true,
+    "noEmit": true,
+    "types": [
+      "node"
+    ]
+  },
+  "include": [
+    "src/**/*.ts",
+    "test/**/*.ts"
+  ]
+}