Home

TARS 코드베이스 분석

세션: analyze-20260426-tars-docs-refresh 생성일: 2026-04-26

이 위키는 .analysis/outputs 산출물을 GitHub Wiki 형식으로 게시한 결과입니다.

문서 목록

문서	설명
01 프로젝트 개요	프로젝트 목적, 핵심 흐름, 상태 저장 구조
02 아키텍처	레이어 구조와 요청/실행 흐름
03 사용 기술	언어, 라이브러리, 런타임 의존성
04 용어 사전	주요 런타임 개념과 용어
05 튜토리얼	신규 기여자용 따라 읽기 가이드
06 클론 코딩	최소 버전 구현 순서와 참고 파일
07 구현 체크리스트	기능 개발 및 검증 체크리스트

모듈 분석

모듈	설명
Agent Runtime	internal/agentruntime은 비동기 run lifecycle, executor registry, workspace agent, channel message, persistence, run event stream을 관리한다.
CLI와 Client	cmd/tars는 Cobra 기반 얇은 진입점이다. root 명령은 콘솔을 열거나 --message one-shot chat을 실행하고, subcommand들은 대부분 pkg/tarsclient/internal/tarsclient를 통해 서버 API를 호출한다.
Extensions	Skill, Plugin, MCP, Skill Hub는 core prompt/tool surface를 키우지 않고 기능을 on-demand로 불러오기 위한 확장 시스템이다.
Frontend Console	frontend/console은 TARS의 주 UI다. Chat, Memory, System Prompt, Ops, Pulse, Reflection, Extensions, Config 화면을 제공한다.
Memory	internal/memory와 chat memory hook은 장기 기억, semantic search, daily log, experiences, compaction index를 다룬다.
System Surfaces	Pulse, Reflection, Ops는 사용자 채팅과 분리된 system surface다. 이들은 LLM/tool registry를 사용자 surface와 섞지 않고, 좁은 Go interface를 통해 runtime 상태를 관찰하거나 운영 작업을 수행한다.
tarsserver	internal/tarsserver는 TARS runtime의 조립 지점이다. config, LLM router, session store, tool registry, cron, pulse, reflection, agent runtime, ops, console static serving을 하나의 HTTP mux로 묶는다.