Local-CLI

LOCAL-CLI Roadmap

문서 버전: 7.0.0 (v2.7.0) 최종 수정일: 2025-12-19 작성자: Development Team

1. 개요

1.1 현재 아키텍처 (v2.7.0)

항목	상태
실행 모드	Auto Mode (자율 실행)
Plan-Execute	자동 요청 분류 + TODO 기반 실행
도구 분류	6가지 분류 시스템
사용량 추적	세션/일별/월별 통계
문서 관리	/docs download agno, adk
Git Auto-Update	자동 업데이트 + spinner 애니메이션

2. v2.7.0 완료 기능 ✅

목표: TODO UI 개선 및 사용자 경험 향상 상태: ✅ 완료

2.1 Notion-style TODO UI

기능	설명
체크박스 아이콘	☐ (대기), ☑ (완료), ☒ (실패)
취소선	완료된 항목에 취소선 표시
dots2 스피너	진행 중 항목에 ⣾ ⣽ ⣻ ⢿ 애니메이션
프로그레스 바	TODO 진행률 시각화

2.2 상태바 개선

기능	설명
star 스피너	✶ ✸ ✹ ✺ 애니메이션
진행률 표시	“2/5 tasks” 형식
현재 도구명	edit_file, read_file 등 실행 중인 도구 표시
상태 메시지	Thinking, Compacting, Generating response

2.3 로딩 애니메이션

기능	설명
shark 스피너	초기 로딩 화면에 shark 애니메이션
/compact 로딩	Compact 실행 시 shark 스피너 표시

2.4 Planning LLM 개선

기능	설명
create_todos Tool	TODO 생성 전용 도구
대화 히스토리 유지	Compact 후에도 맥락 전달
TODO 상태 동기화	진행 상황과 TODO 상태 일치 강조

2.5 버그 수정

UI 빈 줄 렌더링 문제 수정
첫 번째 TODO 애니메이션 즉시 표시
React Hooks 순서 오류 수정
response_to_user 도구 제거 (단순화)

3. v1.0.0 완료 기능

3.1 Phase 1: Plan-Execute Auto Mode ✅

✅ 요청 분류 시스템 (simple_response / requires_todo)
✅ update-todo-list LLM Tool
✅ get-todo-list LLM Tool
✅ ESC 키 Human Interrupt
✅ Plan 승인 제거 (자동 실행)

2.2 Phase 2: ask-to-user Tool ✅

✅ ask-to-user LLM Tool (2-4개 선택지 + “Other”)
✅ AskUserDialog UI 컴포넌트
✅ LLM이 사용자에게 질문/확인 가능

2.3 Phase 3: 사용량 추적 ✅

✅ /usage 명령어
✅ 세션 레벨 토큰 취합
✅ Claude Code 스타일 상태바
- ✶ ~하는 중… (esc to interrupt · 2m 7s · ↑ 3.6k tokens)
✅ 일별/월별/전체 통계
✅ ~/.local-cli/usage.json 저장

2.4 Phase 4: 문서 다운로드 내재화 ✅

✅ /docs 명령어 (정보 표시)
✅ /docs download <source> (agno, adk)
✅ 설치 상태 표시 (✅/⬜)
✅ sparse checkout으로 docs 폴더만 다운로드
✅ 개발팀 사전 정의 소스만 지원 (보안)

3. Phase 5: Supervised Mode (실행 모드) ✅

목표: 사용자가 AI의 파일 수정 Tool 실행을 승인/거부할 수 있는 모드 우선순위: 🔴 높음 상태: ✅ 완료 (v1.2.x)

3.1 개요

두 가지 실행 모드를 제공하여 사용자가 AI 자율성 수준을 선택할 수 있습니다.

모드	설명	Tool 실행
Auto Mode	자율 실행	모든 도구 자동 실행
Supervised Mode	파일 수정 시 승인 필요	`create_file`, `edit_file`만 승인 필요

3.2 모드 전환

Tab 키           → Auto ↔ Supervised 토글
상태바           → 현재 모드 표시 [Auto] 또는 [Supervised]

3.3 승인이 필요한 도구

도구	승인 필요	설명
`create_file`	✅	새 파일 생성
`edit_file`	✅	기존 파일 수정
`read_file`	❌	파일 읽기
`list_files`	❌	디렉토리 목록
`find_files`	❌	파일 검색
`tell_to_user`	❌	메시지 전달
`ask_user`	❌	사용자에게 질문

3.4 승인 다이얼로그

┌─────────────────────────────────────────────────────────────┐
│  🔧 create_file                                              │
│  ───────────────────────────────────────────────────────    │
│  📁 file_path: /src/utils/helper.ts                          │
│  📝 content: export function helper() { ... }                │
│  ───────────────────────────────────────────────────────    │
│  ▸ [1] ✅ Approve                                            │
│    [2] ❌ Reject                                             │
│  ───────────────────────────────────────────────────────    │
│  ↑↓ 이동 | Enter 선택 | 1-2 번호 선택                          │
└─────────────────────────────────────────────────────────────┘

3.5 거부 시 코멘트 흐름

Reject 선택
    ↓
┌─────────────────────────────────────────────┐
│  💬 AI에게 전달할 코멘트를 입력하세요:        │
│  > 이 파일 대신 existing-helper.ts를 수정해줘 │
└─────────────────────────────────────────────┘
    ↓
코멘트가 AI의 다음 메시지로 전달
    ↓
AI가 피드백 반영하여 재시도

3.6 구현 완료 항목

ExecutionMode 타입 정의 ('auto' | 'supervised')
executionMode 상태 (PlanExecuteApp)
ApprovalDialog UI 컴포넌트
Tab 키 모드 토글
상태바 모드 표시
Tool 실행 전 승인 체크 로직 (콜백 시스템)
거부 시 코멘트 → AI 메시지 전달
Static Log에 승인/거부 로그 표시

3.7 추가 구현 사항 (v1.2.x)

parallel_tool_calls: false API 파라미터로 단일 Tool 실행 강제
Context 표시 형식 변경: Context (1.3K / 13%)
maxIterations 제한 제거 (무제한 Tool 실행)
코드베이스 이해 우선 지시문 추가

4. Phase 5.5: Session Management (최우선) 🚨

목표: 완벽한 세션 관리 및 사용자 제어 강화 우선순위: 🔴🔴 최우선 (Phase 6 이전 필수) 상태: 🔲 구현 예정

4.1 개요

세션 저장/복구, 인터럽트, 사용자 입력 큐잉 등 핵심 UX 기능을 완벽하게 구현합니다.

4.2 Auto Save / Load

기능	설명
Auto Save	매 메시지/Tool 실행 후 자동 저장
Auto Load	앱 시작 시 마지막 세션 자동 복구 옵션
`/load`	저장된 세션 목록에서 선택하여 복구
`/save`	현재 세션 수동 저장 (이름 지정 가능)

~/.local-cli/projects/{cwd}/
├── auto_session.json        # 자동 저장 세션
├── session_2025-12-12.json  # 수동 저장 세션
└── ...

4.3 Session Load 시 메시지 히스토리 복원

세션 로드 시 이전 대화가 마치 방금 채팅한 것처럼 Static Log에 표시됩니다.

┌─────────────────────────────────────────────────────────────┐
│  📂 세션 복구됨: 2025-12-12 14:30                            │
│  ───────────────────────────────────────────────────────    │
│  👤 You: 프로젝트에 로깅 시스템을 추가해줘                      │
│  ───────────────────────────────────────────────────────    │
│  📖 read_file: src/index.ts                                 │
│  ⎿ 파일 내용 (15줄)                                          │
│  ───────────────────────────────────────────────────────    │
│  📝 create_file: src/utils/logger.ts                        │
│  ⎿ 파일 생성 완료                                            │
│  ───────────────────────────────────────────────────────    │
│  🤖 Assistant: 로깅 시스템을 추가했습니다...                   │
└─────────────────────────────────────────────────────────────┘

구현 항목:

세션 저장 시 LogEntry[] 배열도 함께 저장
세션 로드 시 저장된 LogEntry[]를 Static Log에 복원
복원된 메시지에 “복구됨” 표시 또는 구분선

4.4 Supervised Mode + Session Load

세션 로드 시 autoApprovedTools Set 초기화:

// 세션 로드 시
autoApprovedTools.clear();  // 기존 자동 승인 목록 초기화
// → 모든 파일 수정 도구에 대해 다시 승인 필요

이유: 새로운 세션 컨텍스트에서는 이전 승인이 유효하지 않을 수 있음

4.5 ESC 즉시 중단 (Interrupt)

ESC 키 누르면 즉시 중단되어야 합니다:

User가 ESC 누름
    ↓ (즉시)
┌─────────────────────────────────────────────────────────────┐
│  ⎿ Interrupted                                              │  ← 빨간색
└─────────────────────────────────────────────────────────────┘
    ↓
- LLM 응답 대기 중이면 → 응답 폐기, 요청 취소
- Tool 실행 중이면 → 가능한 경우 중단
- 상태 즉시 idle로 전환
- 입력창 활성화

구현 항목:

AbortController 사용하여 진행 중인 HTTP 요청 취소
ESC 시 isProcessing = false 즉시 설정
Static Log에 빨간색 ⎿ Interrupted 메시지 추가
진행 중이던 partial 응답 폐기

4.6 사용자 메시지 큐잉 (User Message Queue)

LLM 처리 중에 사용자가 메시지를 입력하면 큐에 저장:

LLM 응답 생성 중...
    ↓
User가 메시지 입력: "잠깐, 그거 말고 다른 방법으로 해줘"
    ↓
메시지 큐에 저장
    ↓
현재 Tool call 완료 (tool response 포함)
    ↓
다음 LLM invoke 시 마지막 메시지로 포함:
┌─────────────────────────────────────────────────────────────┐
│  messages: [                                                │
│    ...이전 메시지들,                                          │
│    { role: "user", content: "[Request interrupted by user]  │
│      잠깐, 그거 말고 다른 방법으로 해줘" }                      │
│  ]                                                          │
└─────────────────────────────────────────────────────────────┘

구현 항목:

pendingUserMessage 상태 추가
처리 중 입력 시 큐에 저장 (입력창은 비활성화하지 않음)
Tool response 완료 후 큐 확인
큐에 메시지가 있으면 [Request interrupted by user]\n{message} 형식으로 추가
큐 메시지 처리 후 큐 비우기

4.7 구현 항목 체크리스트

Auto Save / Load:

매 메시지 후 자동 저장 로직
앱 시작 시 자동 복구 옵션
/load 명령어 개선 (UI로 세션 선택)
/save [name] 명령어 추가

Session Load 메시지 복원:

LogEntry[] 세션 파일에 저장
로드 시 Static Log에 복원
복원 시 “세션 복구됨” 헤더 표시

Supervised Mode 초기화:

세션 로드 시 autoApprovedTools.clear() 호출
로드 후 모든 파일 수정 도구 재승인 필요

ESC 즉시 중단:

AbortController 통합
ESC 시 HTTP 요청 취소
빨간색 ⎿ Interrupted 로그 표시
상태 즉시 초기화

User Message Queue:

pendingUserMessage 상태
처리 중 입력 감지 및 큐잉
[Request interrupted by user] 프리픽스로 다음 invoke에 포함
큐 처리 후 초기화

5. Phase 6: Codebase RAG

목표: 대규모 코드베이스를 LLM이 이해하기 쉽게 인덱싱 우선순위: 🟡 중간

5.1 `/indexing` User Command

/indexing                 # 도움말
/indexing start           # 코드베이스 인덱싱 시작
/indexing status          # 인덱싱 상태 확인
/indexing refresh         # 변경된 파일만 재인덱싱

5.2 인덱스 구조

interface CodebaseIndex {
  projectPath: string;
  lastIndexed: string;
  structure: {
    entryPoints: string[];      // 진입점 파일
    configFiles: string[];      // 설정 파일
    modules: ModuleSummary[];   // 모듈별 요약
  };
  files: {
    [path: string]: {
      type: 'code' | 'config' | 'docs' | 'test';
      summary: string;          // LLM 생성 요약
      exports?: string[];       // 내보내는 함수/클래스
      dependencies?: string[];  // 의존성
    };
  };
}

5.3 구현 항목

6. Phase 7: MCP 기능 지원

목표: Model Context Protocol 통합 우선순위: 🟡 중간

6.1 MCP Client 구현

MCP 프로토콜 구현 (JSON-RPC)
stdio 전송 지원
SSE 전송 지원
서버 연결/해제 관리

6.2 `/mcp` User Command

/mcp                      # 도움말
/mcp list                 # 연결된 서버 목록
/mcp add <config>         # 서버 추가
/mcp remove <server>      # 서버 제거
/mcp enable <tool>        # 도구 활성화
/mcp disable <tool>       # 도구 비활성화

6.3 MCP Tool 통합

MCP Tool을 LLM Tool로 자동 등록
Tool Selector와 연동 (Phase 8)

7. Phase 8: Tool Selector

목표: LLM Tool이 많아질 경우 성능 저하 방지 우선순위: 🟢 낮음 (Tool이 많아진 후 구현)

7.1 문제 정의

현재: 모든 LLM Tool을 프롬프트에 포함
문제: Tool 수 증가 → 프롬프트 길이 증가 → 성능 저하

7.2 해결 방안

User 요청
    ↓
┌─────────────────────────────────┐
│  Tool Selector (경량 LLM 호출)   │
│  "이 요청에 필요한 도구 선택"     │
└─────────────────────────────────┘
    ↓
선택된 Tool만 포함하여 메인 LLM 호출

7.3 구현 항목

tools/selector/ 폴더 구조 생성
Tool 메타데이터 정의 (name, description, keywords)
Tool Selector 인터페이스 정의

8. 우선순위 매트릭스

8.1 구현 순서

Phase	항목	상태	우선순위
1	Plan-Execute Auto Mode 강화	✅ 완료	-
2	ask-to-user Tool	✅ 완료	-
3	사용량 추적	✅ 완료	-
4	문서 다운로드 내재화	✅ 완료	-
5	Supervised Mode (실행 모드)	✅ 완료	-
5.5	Session Management	🔲 예정	🔴🔴 최우선
6	Codebase RAG	🔲 예정	🟡 중간
7	MCP 기능 지원	🔲 예정	🟡 중간
8	Tool Selector	🔲 예정	🟢 낮음

8.2 권장 구현 순서

Phase 5.5 → Phase 6 → Phase 7 → Phase 8
    ↓          ↓         ↓         ↓
  세션       코드      외부      최적화
  관리       분석      연동     (나중에)

이 문서는 프로젝트 진행에 따라 지속적으로 업데이트됩니다.

This site is open source. Improve this page.

Local-CLI

LOCAL-CLI Roadmap

목차

1. 개요

1.1 현재 아키텍처 (v2.7.0)

2. v2.7.0 완료 기능 ✅

2.1 Notion-style TODO UI

2.2 상태바 개선

2.3 로딩 애니메이션

2.4 Planning LLM 개선

2.5 버그 수정

3. v1.0.0 완료 기능

3.1 Phase 1: Plan-Execute Auto Mode ✅

2.2 Phase 2: ask-to-user Tool ✅

2.3 Phase 3: 사용량 추적 ✅

2.4 Phase 4: 문서 다운로드 내재화 ✅

3. Phase 5: Supervised Mode (실행 모드) ✅

3.1 개요

3.2 모드 전환

3.3 승인이 필요한 도구

3.4 승인 다이얼로그

3.5 거부 시 코멘트 흐름

3.6 구현 완료 항목

3.7 추가 구현 사항 (v1.2.x)

4. Phase 5.5: Session Management (최우선) 🚨

4.1 개요

4.2 Auto Save / Load

4.3 Session Load 시 메시지 히스토리 복원

4.4 Supervised Mode + Session Load

4.5 ESC 즉시 중단 (Interrupt)

4.6 사용자 메시지 큐잉 (User Message Queue)

4.7 구현 항목 체크리스트

5. Phase 6: Codebase RAG

5.1 /indexing User Command

5.2 인덱스 구조

5.3 구현 항목

6. Phase 7: MCP 기능 지원

6.1 MCP Client 구현

6.2 /mcp User Command

6.3 MCP Tool 통합

7. Phase 8: Tool Selector

7.1 문제 정의

7.2 해결 방안

7.3 구현 항목

8. 우선순위 매트릭스

8.1 구현 순서

8.2 권장 구현 순서

5.1 `/indexing` User Command

6.2 `/mcp` User Command