SemiColony CLI (@team-semicolon/semicolony-cli)

SemiColony — 자기 KB 위에 봇 하네스를 올리는 메타 프레임워크 (CLI). 개인은 노트북 한 대로, 팀은 PostgreSQL 위에서 동일 엔진을 공유한다.

30초 설치

npm install -g @team-semicolon/semicolony-cli
semicolony init            # 프로파일 선택 → ~/.semicolony 생성
semicolony migrate-sqlite  # KB/Ops 스키마 적용 (Personal 기본)
semicolony doctor          # 설치 헬스체크

또는 일회성 실행:

npx @team-semicolon/semicolony-cli init

프로파일 — 5분 안에 결정

semicolony init 첫 화면에서 선택한다. 운영 환경이 바뀌면 ~/.semicolony/config.toml 만 교체하면 된다.

| 프로파일 | KB | 실행 타깃 | 메신저 | 용도 | | ------------------------- | ----------- | ------------------------ | --------------- | -------------------------------------------------------------------- | | personal-discord (기본) | SQLite | Ollama (로컬 LLM) | Discord 봇 | 노트북 1대, 자기만의 에이전트 — 데이터 로컬, 인터넷 다운돼도 KB 사용 | | personal-offline | SQLite | Ollama | stdin (CLI) | 메신저 없이 터미널만으로 | | solo-connected | SQLite | Anthropic API | HTTP/Obsidian | 클라우드 LLM + Tailscale 외부 접근 | | team | PostgreSQL | Claude Code Orchestrator | Slack + Discord | 여러 명이 같은 KB 공유 (팀/스타트업) | | custom | 빈 스켈레톤 | — | — | 직접 편집 |

세미콜론 팀도 team 프로파일의 한 사용자일 뿐. SemiColony는 메타 프레임워크.

1분 만에 Personal Discord 봇 띄우기

# 1. Ollama 설치 + 모델
brew install ollama && ollama serve &
ollama pull qwen2.5-coder:14b
ollama pull nomic-embed-text

# 2. SemiColony 초기화
semicolony init --profile personal-discord
semicolony migrate-sqlite

# 3. Discord 봇 등록 (https://discord.com/developers/applications 에서 생성 후)
export DISCORD_TOKEN='your-bot-token'   # ~/.zshrc 또는 direnv 에 영구 저장 권장
semicolony doctor                        # ✓ Discord 봇 토큰 확인

# 4. Router 데몬 기동 (포그라운드, Ctrl+C 종료)
semicolony router start --platform discord

# 5. 첫 KB 채우기 — 대화형 온보딩 (별 터미널)
semicolony onboard    # 닉네임/역할/관심사/목표 → me/* 자동 저장
# 또는 자연어 factory:
semicolony factory apply "오늘 회의에서 Notion 도입 결정됨" --yes

이제 Discord 채널에서 @SemiColonyBot 안녕을 보내면 로컬 Ollama가 KB와 함께 응답한다. 자세한 단계별 절차는 packages/cli/PERSONAL_TESTING.md 참고.

3-Layer 아키텍처 (요약)

| Layer | 소유자 | 내용 | | ---------------------- | ----------- | -------------------------------------------------------------------------------------------------- | | L0 SemiColony Core | npm 공개 | SemiColonyBot 오케스트레이터, KB/Ops 인프라, 봇 템플릿 카탈로그 (@team-semicolon/semicolony-cli) | | L1 Profile | 사용자 선택 | ~/.semicolony/config.toml — KB 드라이버 / 메신저 / LLM 타깃 | | L2 Tenant | 사용자 소유 | 자기 도메인 KB 엔트리, 봇 인스턴스, 자유 CRUD |

업그레이드 시 L0 만 semicolony update 로 갱신, L2 데이터는 그대로.

봇 카탈로그

semicolony templates list 로 사용 가능한 역할 템플릿 목록. SemiColonyBot 외 모든 봇은 템플릿 → 복사 → 사용자 정의 흐름.

| ID | 역할 | 강점 | | ----------------------- | ----------------- | -------------------------------- | | semicolonyclaw (필수) | 오케스트레이터 | 사용자 의도 → 적절한 봇 dispatch | | planclaw | 기획/PRD | 요구사항 정리, 스펙 작성 | | workclaw | 풀스택 구현 | 코드 작성, 마이그레이션 | | reviewclaw | 코드 리뷰/QA | PR 리뷰, 테스트 설계 | | designclaw | 디자인/퍼블리싱 | UI 설계, Figma 핸드오프 | | growthclaw | SEO/마케팅/그로스 | KPI, 콘텐츠 | | infraclaw | DevOps/배포 | 인프라, CI/CD |

내 도메인에 맞춰 템플릿을 복사하거나 SemiColonyBot 과의 대화로 새 봇을 만들 수 있다 (semicolony factory apply "...").

자주 쓰는 명령

| 작업 | 명령 | | -------------- | ---------------------------------------------------------------- | | 초기화 | semicolony init [--profile <name>] | | KB 검색 | semicolony kb search "키워드" | | KB 조회 | semicolony kb get <도메인> <키> [<sub_key>] | | KB 저장 | semicolony kb upsert <도메인> <키> [<sub_key>] --content "..." | | Discord 라우터 | semicolony router start --platform discord (Slack 미지원) | | 봇 템플릿 목록 | semicolony templates list | | 봇 생성 | semicolony factory apply "기획 봇 만들어줘" | | LLM 실행 | semicolony exec "프롬프트" | | 채팅 REPL | semicolony chat --target ollama --model qwen2.5-coder:14b | | 첫 온보딩 | semicolony onboard (me/* KB 자동 채움) | | 헬스체크 | semicolony doctor | | 업그레이드 | semicolony update |

환경변수

| 변수 | 용도 | | ------------------------ | -------------------------------------------------------------------------- | | SEMICOLONY_HOME | 기본 ~/.semicolony 변경. 한 머신에서 Team/Personal 프로파일 분리 시 유용 | | SEMICOLONY_CONFIG_PATH | config.toml 경로 직접 지정 | | ANTHROPIC_API_KEY | solo-connected / team 프로파일 | | DISCORD_TOKEN | Discord 봇 토큰 (Personal Discord 프로파일 필수) | | SLACK_BOT_TOKEN | Slack 봇 토큰 (Team 프로파일) | | OLLAMA_HOST | Ollama 호스트 변경 (기본 http://127.0.0.1:11434) |

설치/AX 컨설팅 문의

• 엔진어: 무료 (OSS, Apache-2.0)
• 설치/온톨로지 컨설팅: 세미콜론 팀에서 유상 제공 (Discord/Slack DM)
• 베타 사용자: GitHub Issues 또는 Discord 커뮤니티

참고

• 메인 레포: https://gitlab.semi-colon.space/semicolon-devteam/semicolony
• 3-Layer 설계: docs/ARCHITECTURE.md
• 자주 묻는 질문: docs/FAQ.md

라이선스

Apache-2.0