자율형 AI 에이전트 관리 도구
해커뉴스에 터미널 대시보드, 웹 UI, 선언적 설정(YAML/Markdown)을 통해 지속적으로 구동되는 자율형 AI 봇을 관리하는 오픈소스 도구인 botctl이 소개되었습니다. 이 도구는 Claude 기반의 에이전트를 생성·실행·모니터링하며, 세션 메모리와 핫 리로드를 지원해 개발자가 코드 리뷰, 날씨 모니터링 등의 반복 업무를 자동화할 수 있게 돕습니다.
[ AI 에이전트용 프로세스 매니저 ] 터미널 대시보드, 웹 UI, 선언적 구성을 통해 영구적인 AI 봇을 관리하세요.
macOS / Linux: $ curl -fsSL https://botctl.dev/install.sh | sh Windows:
irm https://botctl.dev/install.ps1 | iex
GitHub 빠른 시작
BOTCTL bots: 2/3 active cost: $4.51
NAME STATUS RUNS COST
msg> check the error logs s stop m message q quit $
작동 방식
01 선언적 구성 (Declarative config) 설정을 위한 YAML 프론트매터와 프롬프트를 위한 마크다운 본문을 사용합니다.
name: code-reviewer interval_seconds: 60 max_turns: 20
Review open PRs and post comments...
02 자율 실행 (Autonomous execution) 지정한 프롬프트, 도구, 워크스페이스와 함께 Claude를 실행합니다. 실행, 로깅, 대기를 반복합니다.
$ botctl start code-reviewer -d ✓ Harness started (pid 48201) $ botctl logs code-reviewer -f [run #1] Reviewing PR #49...
03 세션 메모리 (Session memory) 모든 실행은 세션을 저장합니다. Claude가 중단한 부분부터 다시 시작하거나, 실행 중인 봇에 메시지를 보내 방향을 전환할 수 있습니다.
$ botctl start review --message "focus on PR 51" ✓ Message queued, waking bot...
04 핫 리로드 (Hot reload) BOT.md를 편집하면 다음 실행 시 변경 사항이 즉시 반영됩니다. 재시작, 배포, 다운타임이 필요 없습니다.
change max_turns in BOT.md
max_turns: 20 → max_turns: 50
next run uses new value automatically
05 확장 가능한 스킬 (Extensible skills) GitHub에서 재사용 가능한 스킬 모듈을 검색, 설치 및 공유하세요. 스킬은 모든 봇의 프롬프트에 새로운 기능을 주입합니다.
$ botctl skills search slack $ botctl skills add owner/repo --skill slack-notify $ botctl skills list
06 웹 대시보드 (Web dashboard) 브라우저에서 봇을 모니터링하고 제어하세요. TUI와 동일한 기능(시작, 중지, 메시지 전송, 로그 스트리밍)을 제공합니다.
$ botctl --web-ui ✓ Dashboard at http://localhost:4444 $ botctl --web-ui --port 8080
빠른 시작
01 설치 (Download) 체크섬 검증과 함께 최신 바이너리를 다운로드합니다. AMD64 및 ARM64 아키텍처의 macOS, Linux, Windows를 지원합니다.
macOS / Linux: $ curl -fsSL https://botctl.dev/install.sh | sh Windows:
irm https://botctl.dev/install.ps1 | iex
02 봇 생성 (Create a bot) Claude를 통한 대화형 생성으로 봇의 이름, 스케줄, 시스템 프롬프트가 포함된 BOT.md 구성 파일을 생성합니다.
$ botctl create my-bot
Opens interactive creation with Claude
Or with flags:
$ botctl create my-bot -d "Monitor weather APIs" -i 300 -m 20
03 대시보드 실행 (Launch the dashboard) TUI 대시보드를 열어 모든 봇을 모니터링하고 제어하세요. 또는 웹 UI를 통해 브라우저에서 접근할 수 있습니다.
Terminal dashboard
$ botctl
Web dashboard
$ botctl --web-ui # port 4444 $ botctl --web-ui --port 8080
04 봇 제어 (Control your bots) CLI 또는 대시보드에서 봇을 시작, 중지, 메시지 전송 및 재개합니다. 봇은 백그라운드 프로세스로 실행됩니다.
$ botctl start my-bot --detach $ botctl start my-bot --message "check the error logs" $ botctl logs my-bot -f $ botctl stop my-bot
문서 (docs/) ▸ 시작하기 (Getting Started): 개요 (Overview), 설치 (Installation) ▸ 설정 (Configuration): BOT.md 프론트매터 (Frontmatter), 스킬 (Skills), 워크스페이스 (Workspaces), 환경변수 (Environment) ▸ 인터페이스 (Interfaces): CLI 참조 (Reference), TUI 대시보드 (Dashboard), 웹 UI (Web UI) ▸ 내부 구조 (Internals): 하니스 루프 (Harness Loop), 세션 (Sessions), 데이터베이스 (Database), 파일 레이아웃 (File Layout)