TIMO

Think · Idea-Manager · Operation — Claude Code를 쓰듯이 자연어로 요청하면, AI가 파일을 직접 읽고 쓰고 실행하면서 작업 태스크를 스스로 정리해주는 로컬 툴.

idea-manager(im)의 후속작(im.v2)입니다. 이전 버전이 태스크 "정리"에만 머물렀다면, TIMO는 직접 실행과 유기적 루프까지 가져갑니다.

스크린샷

좌측 사이드바에 프로젝트·세션, 중앙에 Claude Code 스타일 채팅(도구 호출 + 결과 인라인 표시), 우측에 AI가 TodoWrite로 만든 태스크 리스트가 실시간 반영됩니다.

설치

npm install -g @navskh/timo
timo start

http://localhost:3789/ 가 자동으로 열립니다.

전제 조건

TIMO는 여러분의 CLI 에이전트를 스폰해서 동작합니다. 최소 하나는 설치되어 있어야 합니다:

• Claude (추천): https://docs.claude.com/en/docs/claude-code/overview
• Gemini CLI: https://github.com/google-gemini/gemini-cli
• Codex CLI: OpenAI Codex CLI

각 에이전트에 로그인 / 구독 / API 키 설정은 해당 CLI 문서를 따라주세요.

사용법

timo start                  # 기본 포트 3789
timo start --port 4000      # 포트 지정
timo start --no-open        # 브라우저 자동 열기 안 함
timo --help                 # 도움말

기본 흐름

1. 새 프로젝트 — 사이드바에서 이름·작업 디렉토리·에이전트 선택
2. 채팅으로 요청 — Claude Code에 말하듯이 ("여기서 OAuth 버그 찾아줘", "폴더별로 README 써줘" 등)
3. AI가 작업 + TodoWrite — 파일을 읽고 쓰고 실행하면서 생긴 모든 todo가 우측 태스크 패널에 자동 반영
4. 수동 태스크 추가 — 원하면 사이드바 상단 + 직접 추가…로 직접 적어두기
5. 다음 턴에서 이어서 — 이전 대화와 현재 태스크 상태가 프롬프트에 자동 주입되어 자연스럽게 이어짐

Skills

/plan, /build, /review, /design, /docs 5개 스킬이 기본 탑재돼 있어요. 채팅에 /plan 치면 AI가 기획·분석 모드로 응답하고, /build는 "기존 컨벤션 먼저 스캔" 규칙을 강제합니다.

/plan 이 기능을 도입하면 뭐가 문제야?
/build 위 계획대로 구현해줘
/review 방금 한 거 회귀 리스크 체크

스킬은 ~/.timo/skills/*.md 파일로 저장되며, 앱 내 관리 메뉴에서 추가/수정/삭제할 수 있습니다.

저장 위치

모든 데이터는 로컬입니다 — 외부로 나가지 않아요.

• ~/.timo/data/timo.db — 프로젝트·세션·태스크·메시지 (SQLite)
• ~/.timo/skills/*.md — 스킬 정의

포트 충돌 시

lsof -t -i :3789 | xargs kill -9
timo start

개발

git clone ...
npm install
npm run dev        # 개발 서버 (hot reload)
npm run build      # standalone 빌드
npm start          # 빌드된 서버 기동

라이선스

MIT © navskh