What it does
5D living code graph, AST symbol editing, refactoring & blast-radius gate in 1 Rust binary
- Connects 내 컴퓨터에서 실행
- Account or key No key needed
- Category 개발자 도구
함께 쓰기
이런 작업을 AI에게 가르치는 Skill, 이것과 함께 쓸 수 있습니다
andrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
graphify
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
이 순위인 이유
목록은 사용 점수(100점 만점)로 정렬되며 구성은 다음과 같습니다
| 인기 | 7/80 | GitHub 별 또는 주간 다운로드: 큰 쪽 60, 작은 쪽 20 |
|---|---|---|
| 최신성 | 12/12 | 30일 안에 릴리스나 코드 변경이 있으면 만점 |
| 응답 중 | 0/8 | 마지막 점검 때 클라우드 엔드포인트가 응답 |
| 사용 점수 | 19/100 |
품질: 기본 점검 3/3개 통과(표시만, 정렬에는 안 씀) · 상승세: 데이터 없음 (급상승 탭에서만 사용)
설치
쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.
한 문장으로 AI에게 설치 맡기기
CHRONOS-AGENT 설치해 줘. https://mcp.popnx.com/i/ptai-eng-chronos-agent.md 를 따라 하고, 명령을 먼저 보여 주고 내가 승인하면 실행해.내 컴퓨터에서 작업하는 AI(Claude Code, Cursor 등)에 붙여 넣으세요. 단계를 읽고 명령을 보여 준 뒤 승인을 기다립니다. 키도 가입도 필요 없습니다. · AI가 읽을 전체 내용 보기
검사 3/3 통과 · 내 컴퓨터에서 실행돼요 · ✓ 명령 확인 2026년 11월 19일
먼저: 어떤 AI를 쓰시나요?
쓰는 앱을 고르면 아래에 단계가 나옵니다.
Claude에 연결할 수 있지만 먼저 준비가 필요해요
먼저 컴퓨터에 Docker를 설치하세요 (한 번만) · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요
AI에게 설치 맡기기
이 메시지를 Claude 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 Claude에 MCP server CHRONOS-AGENT을 설치해 주세요. 순서대로: 1) docker --version로 Docker가 있는지 확인. 없으면 https://www.docker.com/products/docker-desktop/에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): { "mcpServers": { "chronos-agent": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/ptai-eng/chronos-agent:1.8.0" ] } } } 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 CHRONOS-AGENT의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
Docker 설치 (아직 없다면)
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
docker --version- 버전 번호(예: Docker version …)가 나오면 설치된 것입니다. 이 단계는 건너뛰세요
- "command not found"(Windows는 "is not recognized")가 나오면 아직 설치하지 않았거나, 방금 설치해서 터미널을 닫았다가 다시 열어야 합니다
터미널 여는 법
Mac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: Docker Desktop 설치: Mac은 Docker.dmg를 열고 아이콘을 "응용 프로그램"으로 드래그(Mac에 맞게 Apple silicon 또는 Intel 선택) · Windows는 Docker Desktop Installer.exe 더블클릭 · 설치 후 Docker Desktop 앱을 열어 두세요. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다:
docker --version한 번 설치하면 Docker가 필요한 모든 도구에서 쓸 수 있습니다
컴퓨터용 Claude 앱 설정 파일 열기
SettingsDeveloperEdit Config
이 설정을 붙여 넣고 저장
{ "mcpServers": { "chronos-agent": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/ptai-eng/chronos-agent:1.8.0" ] } } }Claude를 끄고 다시 열기
해 보기
CHRONOS-AGENT을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Claude가 CHRONOS-AGENT을 쓰고 있다고 하거나 답에 CHRONOS-AGENT 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
ChatGPT는 아직 CHRONOS-AGENT에 연결할 수 없어요
CHRONOS-AGENT는 내 컴퓨터에 설치해서 쓰지만 ChatGPT는 웹에서 도는 서버만 연결할 수 있어요
대신 이렇게 할 수 있어요
A · CHRONOS-AGENT에 연결되는 앱 쓰기
- 먼저 컴퓨터에 Docker를 설치하세요 (한 번만) · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요
- 먼저 컴퓨터에 Docker를 설치하세요 (한 번만)
- 먼저 컴퓨터에 Docker를 설치하세요 (한 번만)
- 먼저 컴퓨터에 Docker를 설치하세요 (한 번만)
B · 개발자 도구에서 ChatGPT에 연결되는 다른 서버
같은 분류에서 많이 쓰는 것 중 키 없이 주소만으로 연결되는 것을 골랐어요
- Sentry✓ ChatGPT
- Compiler Explorer✓ ChatGPT
- GitDiagram✓ ChatGPT
Claude Code에 연결할 수 있지만 먼저 준비가 필요해요
먼저 컴퓨터에 Docker를 설치하세요 (한 번만)
AI에게 설치 맡기기
이 메시지를 Claude Code 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 Claude Code에 MCP server CHRONOS-AGENT을 설치해 주세요. 순서대로: 1) docker --version로 Docker가 있는지 확인. 없으면 https://www.docker.com/products/docker-desktop/에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): claude mcp add --scope user chronos-agent -- docker run -i --rm ghcr.io/ptai-eng/chronos-agent:1.8.0 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 CHRONOS-AGENT의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
Docker 설치 (아직 없다면)
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
docker --version- 버전 번호(예: Docker version …)가 나오면 설치된 것입니다. 이 단계는 건너뛰세요
- "command not found"(Windows는 "is not recognized")가 나오면 아직 설치하지 않았거나, 방금 설치해서 터미널을 닫았다가 다시 열어야 합니다
터미널 여는 법
Mac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: Docker Desktop 설치: Mac은 Docker.dmg를 열고 아이콘을 "응용 프로그램"으로 드래그(Mac에 맞게 Apple silicon 또는 Intel 선택) · Windows는 Docker Desktop Installer.exe 더블클릭 · 설치 후 Docker Desktop 앱을 열어 두세요. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다:
docker --version한 번 설치하면 Docker가 필요한 모든 도구에서 쓸 수 있습니다
터미널 열기
Mac: Command+스페이스를 누르고 Terminal 입력 · Windows: PowerShell 열기
이 명령을 붙여 넣고 Enter
claude mcp add --scope user chronos-agent -- docker run -i --rm ghcr.io/ptai-eng/chronos-agent:1.8.0Claude Code에서 /mcp 입력
CHRONOS-AGENT이 목록에 있고 연결됨으로 보이면 돼요
해 보기
CHRONOS-AGENT을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Claude Code가 CHRONOS-AGENT을 쓰고 있다고 하거나 답에 CHRONOS-AGENT 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
Cursor에 연결할 수 있지만 먼저 준비가 필요해요
먼저 컴퓨터에 Docker를 설치하세요 (한 번만)
AI에게 설치 맡기기
이 메시지를 Cursor 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 Cursor에 MCP server CHRONOS-AGENT을 설치해 주세요. 순서대로: 1) docker --version로 Docker가 있는지 확인. 없으면 https://www.docker.com/products/docker-desktop/에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): { "mcpServers": { "chronos-agent": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/ptai-eng/chronos-agent:1.8.0" ] } } } 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 CHRONOS-AGENT의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
Docker 설치 (아직 없다면)
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
docker --version- 버전 번호(예: Docker version …)가 나오면 설치된 것입니다. 이 단계는 건너뛰세요
- "command not found"(Windows는 "is not recognized")가 나오면 아직 설치하지 않았거나, 방금 설치해서 터미널을 닫았다가 다시 열어야 합니다
터미널 여는 법
Mac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: Docker Desktop 설치: Mac은 Docker.dmg를 열고 아이콘을 "응용 프로그램"으로 드래그(Mac에 맞게 Apple silicon 또는 Intel 선택) · Windows는 Docker Desktop Installer.exe 더블클릭 · 설치 후 Docker Desktop 앱을 열어 두세요. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다:
docker --version한 번 설치하면 Docker가 필요한 모든 도구에서 쓸 수 있습니다
Cursor에서 AI 채팅을 Agent 모드로 열기
해 보기
CHRONOS-AGENT을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Cursor가 CHRONOS-AGENT을 쓰고 있다고 하거나 답에 CHRONOS-AGENT 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 Cursor 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
VS Code에 연결할 수 있지만 먼저 준비가 필요해요
먼저 컴퓨터에 Docker를 설치하세요 (한 번만)
AI에게 설치 맡기기
이 메시지를 VS Code 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 VS Code에 MCP server CHRONOS-AGENT을 설치해 주세요. 순서대로: 1) docker --version로 Docker가 있는지 확인. 없으면 https://www.docker.com/products/docker-desktop/에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): { "servers": { "chronos-agent": { "type": "stdio", "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/ptai-eng/chronos-agent:1.8.0" ] } } } 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 CHRONOS-AGENT의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
Docker 설치 (아직 없다면)
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
docker --version- 버전 번호(예: Docker version …)가 나오면 설치된 것입니다. 이 단계는 건너뛰세요
- "command not found"(Windows는 "is not recognized")가 나오면 아직 설치하지 않았거나, 방금 설치해서 터미널을 닫았다가 다시 열어야 합니다
터미널 여는 법
Mac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: Docker Desktop 설치: Mac은 Docker.dmg를 열고 아이콘을 "응용 프로그램"으로 드래그(Mac에 맞게 Apple silicon 또는 Intel 선택) · Windows는 Docker Desktop Installer.exe 더블클릭 · 설치 후 Docker Desktop 앱을 열어 두세요. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다:
docker --version한 번 설치하면 Docker가 필요한 모든 도구에서 쓸 수 있습니다
VS Code에서 AI 채팅을 Agent 모드로 열기
해 보기
CHRONOS-AGENT을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ VS Code가 CHRONOS-AGENT을 쓰고 있다고 하거나 답에 CHRONOS-AGENT 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 VS Code 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
개발자용: 터미널 명령과 JSON 설정
컴퓨터에 설치
Claude Code
claude mcp add --scope user chronos-agent -- docker run -i --rm ghcr.io/ptai-eng/chronos-agent:1.8.0Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"chronos-agent": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/ptai-eng/chronos-agent:1.8.0"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"chronos-agent": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/ptai-eng/chronos-agent:1.8.0"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"chronos-agent": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/ptai-eng/chronos-agent:1.8.0"
]
}
}
}이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.
한눈에 보기
- 주간 다운로드i
- npm/PyPI에 없음
- 연결 방식
- 내 컴퓨터에서 실행
- 최신 버전i
- 1.8.0
- 레지스트리 공개i
- 2026년 11월 19일
- 코드 마지막 변경i
- 2026년 11월 19일
- 제작자
- ptai-eng
- 패키지
oci: ghcr.io/ptai-eng/chronos-agent:1.8.0- 웹사이트
- github.com
- 레지스트리 상태
- 활성
어떤 앱에서 쓸 수 있나요
이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 2026년 11월 10일 확인.
내 컴퓨터에서 실행하는 앱
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
할 수 있는 일
내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.
기본 점검i
누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 19일 점검
- ✓ 통과
제작자와 저장소 일치
레지스트리 이름이 GitHub 계정 ptai-eng 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
- ✓ 통과
계속 관리되고 있음
코드 마지막 변경: 오늘
- ✓ 통과
라이선스 있음
MIT 사용
- – 해당 없음
엔드포인트 응답
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
- – 해당 없음
OAuth로 로그인
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
- … 아직 점검 안 함
도구 설명에 숨겨진 지시 없음
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요
제작자: 재확인 요청 또는 잘못된 정보 신고
제작자용: README에 배지 달기
제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.
[](https://mcp.popnx.com/en/servers/ptai-eng-chronos-agent)토론
질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.
사용자 리뷰
아직 리뷰가 없어요
개발자 도구 카테고리의 다른 서버와 비교i
- 이 카테고리의 다른 서버 6182개 중 81%보다 스타가 많아요
- 이 카테고리의 다른 서버 6182개 중 98%보다 최근에 레지스트리에 공개됐어요
- 기본 점검 결과가 이 카테고리의 다른 서버 6182개 중 99%와 같거나 더 좋아요
레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.
자주 묻는 질문
CHRONOS-AGENT, 안전한가요?
해당하는 기본 점검 3개 중 3개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.
어떤 키나 코드가 필요한가요?
레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.
내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?
내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).
아직 관리되고 있나요?
GitHub 저장소는 마지막으로 오늘 변경됐고, 최신 버전(1.8.0)은 오늘 레지스트리에 올라왔어요.
어떤 앱에서 쓸 수 있나요?
Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Docker도 있어야 해요.
대신 쓸 수 있는 건 뭐가 있나요?
같은 카테고리에는: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
비슷하게 동작하는 다른 것
같은 카테고리, 다른 제작자, 명령 확인 완료. 공식이 먼저, 그다음 스타 순.
카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i
GitDiagram
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Appllama
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Omnara
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Repowise
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| 이 항목 CHRONOS-AGENT | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| 실행 위치 | 컴퓨터에 설치 필요 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 | 클라우드 또는 컴퓨터 설치 모두 가능 |
| 키 필요 | 아니요 | 아니요 | 아니요 | 아니요 | 아니요 | 아니요 |
| Claude에서 +로 추가 | 아니요 | 아니요 | 아니요 | 예 | 아니요 | 아니요 |
| 기본 점검 | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| 라이선스 | MIT | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| 가격 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 |
제작자의 README
README 열기
제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.
CHRONOS-AGENT
Single-binary Rust MCP server (Tree-sitter + KuzuDB + Sandboxed Rhai) for fresh-parse AST symbol editing, edge-verified multi-file refactoring, and blast-radius gating. No LSP daemon required.
30-Second Quickstart
Zero-install via `npx` (requires Node.js 18+; auto-fetches your OS release binary):
npx -y @ptai-eng/chronos-mcp --workspace .
Or install prebuilt binaries (`chronos` CLI + `chronos-mcp` server) without Node.js, C++, or Rust:
Windows (PowerShell):
irm https://raw.githubusercontent.com/ptai-eng/chronos-agent/main/scripts/install.ps1 | iex
macOS (Apple Silicon) & Linux (x64):
curl -fsSL https://raw.githubusercontent.com/ptai-eng/chronos-agent/main/scripts/install.sh | sh
*(Other options: cargo-binstall via cargo binstall --git https://github.com/ptai-eng/chronos-agent chronos-cli chronos-mcp, packaging/homebrew/chronos.rb, or OCI container docker run -i --rm -v "${PWD}:/workspace" ghcr.io/ptai-eng/chronos-agent:1.8.1 via the Official MCP Registry.)*
Bootstrap configs for Codex, Antigravity, Claude Code, Cursor, OpenCode, Windsurf, Copilot, and Cline in any workspace:
cd your-project
chronos init --client all --with-hooks
Or drop @ptai-eng/chronos-mcp (or chronos-mcp) directly into any MCP client config:
{
"mcpServers": { "chronos-agent": { "command": "npx", "args": ["-y", "@ptai-eng/chronos-mcp", "--workspace", "."] } } }
Table of Contents
- Why CHRONOS vs. Serena & Built-in Grep
- What's New in v1.8.1 & v1.8.0
- Core Architecture
- Capability Matrix
- 14 Canonical MCP Tools
- VS Code Extension
- CLI Command Suite & Build from Source
- Security & Local-First Guarantees
Why CHRONOS vs. Serena & Built-in Grep
Coding agents normally inspect repositories with sequential grep + line-range reads and apply raw string diffs without knowing who calls a function or whether foo also appears as an unrelated local variable.
| Aspect | Built-in Agent Grep / Line Edits | Daemon LSP MCPs (e.g. Serena) | CHRONOS-AGENT v1.8 |
|---|---|---|---|
| Runtime Model | Text regex per turn | Background language server daemon per language | Single Rust binary (`<15ms` queries, zero daemon) |
| Symbol Editing Safety | Trusts stale line numbers / diff hunks | LSP offsets + text rewrite | Fresh Tree-sitter re-parse on every write + 2-Stage Gate (syntax_error & blocked_requires_force when signature changes on callers) |
| Multi-File Rename | Global text search/replace risks corrupting locals & comments | Compiler/LSP reference list | AST identifier classification separating verified_edits (CALLS/TESTS/imports) from candidate_sites (obj.method(), shadowed locals) + atomic rollback |
| Impact & Test Awareness | None | Caller references when server is warm | KuzuDB graph + Git co-change coupling + Reverse-BFS entrypoints (`verification_surfaces`) + Mutation testing |
| Hybrid Disambiguation (`v1.8.1`) | Zero semantic guarantees | Full compiler type resolution when LSP compiles cleanly | Default zero-daemon (`<15ms`), plus opt-in Hybrid `LspSemanticAdapter` (`use_lsp: true` / `chronos lsp-hydrate`): disambiguates obj.method() candidates with graceful AST fallback |
What's New in v1.8.1 & v1.8.0
v1.8.1 Highlights
- Opt-In Hybrid `LspSemanticAdapter` & `chronos lsp-hydrate`: Resolves
rust-analyzer,typescript-language-server(.cmdwrapper on Windows),pyright,gopls,clangd, andjdtlsoverContent-Lengthstdio JSON-RPC with60s/15stimeouts, UTF-16 byte mapping,use_lsppromotion ofobj.method()candidate_sites, and deterministic AST fallback (coverage.completeness = "partial"). - Polyglot `safe_delete` Interface & Override Guards: Blocks unsafe deletions across TypeScript (
implements/override), Java (@Override/implements), and Go (structural cross-fileinterfacesatisfaction), in addition to Rust trait impls. - MCP Spec & Token Optimization: Suppresses illegal responses to JSON-RPC notifications, decodes
file://Windows/POSIXrootUris, negotiates MCPprotocolVersionup to2025-11-25, emitsToolAnnotations(readOnlyHint,destructiveHint), and compactschronos_explorepayloads (-69% to -72% estimated tokens and 3x–4x fewer round-trips vs. grep+read inbenchmarks/). - Release Parity & Homebrew Formula: Added
scripts/check_version_sync.pyCI guard andpackaging/homebrew/chronos.rb.
v1.8.0 Core Release
v1.8.0 turns CHRONOS-AGENT into a gated read + edit + refactor + script workspace engine across 7 language families (.ts/.tsx/.js/.jsx, .py, .rs, .go, .c/.cpp, .java):
| Subsystem | v1.8.0 Upgrade |
|---|---|
| 1. Fresh-Parse AST Editing (`chronos_edit_symbol` #13 & `chronos edit`) | Reads current bytes from disk and parses a fresh Tree-sitter CST before every edit (declaration_span vs. full_symbol_span). Deduplicates #[attributes], @decorators, and doc-comments, matches target column indentation, preserves UTF-8 BOM & CRLF/LF via AtomicFileWriter, and enforces a 2-Stage Gate (Stage 1 syntax gate + Stage 2 signature contract & fan_in > 0 check). |
| 2. Edge-Verified Refactoring (`chronos_refactor_symbol` #14, `chronos rename`, `chronos delete`) | Classifies AST identifiers while skipping comments and string literals, protects module-path prefixes (use crate::math::math;), blocks blocked_ambiguous_rename on candidates/homonyms/unresolved calls without --force, validates syntax on 100% of touched files before transactional rollback-safe commit, and hardens safe_delete against callers, tests, ApiRoutes, entrypoints, pub/export coverage gaps, and Rust trait impls. |
**3. Progressive Class/* & Batch chronos_explore (#12)** | Supports Class/* wildcard outlines (with per-impl NodeId isolation in Rust), include_body: false signature outlines, depth child expansion, batch queries[], and inline include_blast_radius. |
| 4. Sandboxed `rhai` 5D Script Engine (`chronos_explore.script`, `chronos eval`, `chronos repl`) | Embeds rhai (Engine::new_raw(), bounded at 50_000 ops, zero disk/network/shell I/O) with strict dual profiles: ScriptProfile::ReadOnly for MCP & --readonly CLI, and ScriptProfile::FullCli for gated CLI scripts and interactive REPL sessions. |
| 5. `AtomicFileWriter` & `xxHash64` Deduplication | Transactional multi-file writes roll back all prior modified files on disk error; WorkspaceSession::index_file caches last_indexed_hashes to skip redundant FileWatcher bursts in <0.2ms. |
Previous Releases (v1.7.0, v1.6.0, v1.5.0, v1.4.0, v1.3.0 & v1.2.0)
- v1.7.0: Consolidated
WorkspaceSession, canonicalToolRegistry/McpToolRegistry(zero schema drift), Schema v2GraphRepository,_meta.contract_alertsmiddleware, 24kmax_answer_charsUTF-8 budgeting, and upgraded embedded KuzuDB to single-file0.11.3(cxx-build = 1.0.138) fixing Linux GCC 15 CI aborts. - v1.6.0: Added
chronos_explore, Reverse-BFSverification_surfaces, line-anchoredstructured_findings, 4-Angle Review Audit (Reuse,Efficiency,Simplification,Altitude),<20mslifecycle hooks (chronos hook), and the 20-file multi-agent scaffolder. - v1.5.0: Added
chronos init,chronos agents-md,chronos schemaexporter (OpenAI, Anthropic, Gemini, Codex TOML, MCP), andSECURITY.md. - v1.4.0: Added KuzuDB
xxHash64incremental sync, cross-boundary HTTP route stitching (/{*}), GitCO_CHANGES_WITHco-change mining, single-compileCHRONOS_MUTANT_IDSuper-Mutant evaluation, and offline telemetry hydration (.cpuprofile, Speedscope, Folded Flamegraph, OTLP JSON). - v1.3.0 & v1.2.0: Polyglot 7-language Tree-sitter parser, interprocedural
transitive_loop_depth/ $O(N^2)$ loop scan detection, read-only OpenCypher (chronos_query_graph), BM25 search, Label Propagation clustering, PageRankconfidence_interval, andchronos diff --ci.
Core Architecture
| Component | Responsibility | Crate Path |
|---|---|---|
| Knowledge Graph & Query | Petgraph call/test topology, embedded single-file KuzuDB 0.11.3, OpenCypher, BM25 + Class/* exploration, Git co-change mining | chronos-core/src/graph/ |
| Fresh AST Editor & Refactor | Tree-sitter 7-language parsers, FreshParsedFile trivia spans, AtomicFileWriter, chronos_edit_symbol, chronos_refactor_symbol | chronos-core/src/ast/ |
| Sandboxed Rhai Script Engine | Engine::new_raw() with 50_000 ops ceiling separating ScriptProfile::ReadOnly (MCP) from ScriptProfile::FullCli | chronos-core/src/script/ |
| Contract Broker & Blast Radius | 300ms debounced wa