deus

코딩 에이전트를 위한 소프트스킬 레이어. Claude Code와 Codex 위에서 작동하는 상위 조율자.

비개발자 리더들이 자신의 생각을 전달하면, deus가 이를 구체적인 개발 작업으로 변환하고 적절한 코딩 에이전트를 선택해 실행합니다.

설치

npm install -g deus

또는 소스에서:

git clone https://github.com/yourname/deus
cd deus
npm install
npm run build
npm link

사전 요구 사항

• Claude Code (npm install -g @anthropic-ai/claude-code)
• Codex CLI (npm install -g @openai/codex)
• Anthropic API 키 (deus 두뇌 구동용)

시작하기

1. 초기 설정

deus init

Anthropic API 키와 기본 코딩 에이전트를 설정합니다. 설치된 Claude Code / Codex 연결을 확인합니다.

2. 작업 시작

deus run

deus와 대화하며 원하는 것을 설명하면 됩니다.

나 > 우리 회사 홈페이지에 문의하기 폼을 추가하고 싶어. 이메일로 알림이 오면 좋겠고.

deus > 몇 가지 확인할게요.
       1. 현재 홈페이지는 어떤 기술로 만들어져 있나요? (예: React, 일반 HTML, WordPress 등)
       2. 이메일 알림은 어떤 주소로 받으실 건가요?
       ...

특정 디렉토리에서 작업하려면:

deus run --dir /path/to/project

구조

src/
  adapters/     - Claude Code, Codex CLI 연결
  agent/        - deus 오케스트레이터 (pi-agent-core 기반)
  cli/          - 커맨드라인 인터페이스
  context/      - 컨텍스트 최적화 (긴 세션 관리)
  storage/      - 세션 간 artifact 저장
  tools/        - 에이전트 호출, artifact 읽기/쓰기

개발

npm run dev          # 소스에서 직접 실행
npm run typecheck    # 타입 검사
npm run test:integration  # 통합 테스트 (Claude Code, Codex 설치 필요)
npm run build        # 빌드

라이선스

MIT