Communitygithub.com

dzhng/crm.cli

연락처, 회사, 거래 및 파이프라인을 관리하는 crm.cli — SQLite 기반의 헤드리스 CLI 중심 CRM으로, 가상 파일 시스템 인터페이스를 제공합니다.

crm.cli란 무엇인가요?

crm.cli는 터미널에서 직접 연락처, 회사, 거래 및 파이프라인을 관리할 수 있는 CLI 중심의 헤드리스 CRM 도구입니다. 단일 SQLite 파일에 모든 데이터를 저장하므로, Unix 도구와의 조합이 용이하고 FUSE 또는 NFS를 통해 가상 파일 시스템으로 마운트할 수 있습니다. AI 에이전트(Claude Code, Cursor 등)는 JSON 파일을 직접 읽고 쓰는 방식으로 데이터에 접근할 수 있어, 기존 CLI 명령어를 사용하는 것보다 효율적인 상호작용이 가능합니다. 중복 탐지, 고급 검색(FTS5 및 퍼지 검색), 활동 로깅, 보고서 생성, 가져오기/내보내기 등 CRM에 필요한 핵심 기능을 모두 CLI로 제공하며, 리눅스와 macOS에서 모두 사용할 수 있습니다. AI 에이전트는 `crm mount` 명령어로 마운트한 후 `llm.txt` 파일을 읽고, `_by-email`, `_by-stage` 같은 디렉터리로 빠르게 조회하며, JSON 파일을 읽거나 써서 데이터를 처리할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dzhng/crm.cli/tree/HEAD/skills

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

crm.cli은(는) 무엇을 하나요?

헤드리스 CLI 중심 CRM. 연락처, 거래, 파이프라인을 단일 SQLite 파일에 저장 — 터미널에서 쿼리 가능하고, Unix 도구와 조합 가능하며, 가상 파일 시스템으로 마운트할 수 있습니다.

설치

curl -fsSL https://raw.githubusercontent.com/dzhng/crm.cli/main/install.sh | sh

이 명령어는 미리 컴파일된 바이너리를 ~/.local/bin에 다운로드하고 마운트 종속성(FUSE on Linux, NFS용 macOS Rust 도구체인)을 설치합니다.

설치 후, ~/.local/bin이 PATH에 포함되어 있는지 확인하세요:

export PATH="$HOME/.local/bin:$PATH"

설치 확인:

crm --version

설정

선택 사항. 프로젝트 루트 또는 ~/.crm/config.toml에 crm.toml을 생성하세요:

[database]
path = "~/.crm/crm.db"

[pipeline]
stages = ["lead", "qualified", "proposal", "negotiation", "closed-won", "closed-lost"]
won_stage = "closed-won"
lost_stage = "closed-lost"

[defaults]
format = "table"

[phone]
default_country = "US"
display = "international"

[mount]
default_path = "~/crm"

설정 파일은 현재 디렉토리에서 상위 디렉토리로 올라가며 자동으로 탐색됩니다. --config <path> 또는 CRM_CONFIG 환경 변수로 재정의할 수 있습니다.

글로벌 플래그

모든 명령어는 다음 플래그를 지원합니다:

  • --db <path> — SQLite 데이터베이스 경로 (기본값: ~/.crm/crm.db, env: CRM_DB)
  • --format <fmt> — 출력 형식: table, json, csv, tsv, ids
  • --config <path> — TOML 설정 파일 경로
  • --no-color — 컬러 출력 비활성화

연락처

연락처 생성

crm contact add --name "Jane Doe" \
  --email [email protected] \
  --phone "+1-212-555-1234" \
  --linkedin linkedin.com/in/janedoe \
  --company "Acme Corp" \
  --tag hot-lead \
  --set title=CTO

--name을 제외한 모든 플래그는 선택 사항입니다. 전화번호는 E.164 형식으로 정규화되고, LinkedIn URL은 핸들로 추출되며, 회사는 존재하지 않으면 자동 생성됩니다. --email, --phone, --company, --tag, --set은 모두 반복 사용 가능합니다.

소셜 핸들 플래그: --linkedin, --x, --bluesky, --telegram. 모두 원시 핸들 또는 전체 URL을 허용합니다.

연락처 목록

crm contact list
crm contact list --tag hot-lead --company "Acme Corp"
crm contact list --filter "title~=CTO AND company=Acme" --sort name --limit 20
crm contact list --format json | jq '.[].name'

필터 연산자: =, !=, ~= (포함), >, <. AND / OR로 결합 가능.

연락처 조회

ID, 이메일, 전화번호 또는 소셜 핸들로 조회:

crm contact show ct_01J8ZVXB3K...
crm contact show [email protected]
crm contact show "+12125551234"
crm contact show janedoe          # LinkedIn 핸들

연락처 수정

crm contact edit [email protected] --name "Jane Smith"
crm contact edit "+12125551234" --add-email [email protected] --rm-tag old-tag
crm contact edit janedoe --add-company "New Corp" --set title=CEO --unset source

추가/제거 플래그: --add-email, --rm-email, --add-phone, --rm-phone, --add-company, --rm-company, --add-tag, --rm-tag. 소셜 핸들은 직접 설정: --linkedin, --x, --bluesky, --telegram.

연락처 삭제

crm contact rm [email protected]
crm contact rm "+12125551234" --force    # 확인 생략
crm contact rm janedoe                   # 소셜 핸들로

연락처 병합

두 연락처를 하나로 병합합니다. 첫 번째 연락처는 유지되고, 두 번째는 흡수된 후 삭제됩니다. 모든 참조 유형 허용:

crm contact merge ct_01A... ct_01B...
crm contact merge [email protected] [email protected]
crm contact merge "+12125551234" "+14155559876"
crm contact merge janedoe jane-doe-linkedin

이메일, 전화번호, 회사, 태그, 사용자 정의 필드를 결합하고 모든 거래 및 활동을 재연결합니다.

회사

회사 생성

crm company add --name "Acme Corp" \
  --website acme.com \
  --phone "+1-800-555-0000" \
  --tag enterprise \
  --set industry=SaaS

--website, --phone, --tag, --set은 반복 사용 가능합니다.

목록 / 조회 / 수정 / 삭제

crm company list --tag enterprise
crm company show acme.com                        # 웹사이트로
crm company show "+18005550000"                  # 전화번호로
crm company edit acme.com --name "Acme Inc" --add-website acme.io
crm company rm acme.com --force

회사 병합

crm company merge co_01A... co_01B...
crm company merge acme.com acme.io
crm company merge "+18005550000" "+18005550001"

두 번째 회사의 모든 연락처와 거래를 첫 번째 회사로 재연결합니다.

거래

거래 생성

crm deal add --title "Acme Enterprise" \
  --value 50000 \
  --stage qualified \
  --contact [email protected] \
  --company acme.com \
  --expected-close 2026-06-15 \
  --probability 60 \
  --tag enterprise

연락처와 회사는 존재하지 않으면 자동 생성됩니다. --contact와 --tag는 반복 사용 가능합니다.

거래 목록

crm deal list --stage qualified --min-value 10000
crm deal list --contact [email protected] --sort value --reverse
crm deal list --format ids | wc -l    # 거래 수 계산

파이프라인 단계 이동

crm deal move dl_01... --stage proposal --note "Sent pricing deck"
crm deal move dl_01... --stage closed-won --note "Signed 2-year contract"

단계 전환은 타임스탬프와 함께 활동으로 기록됩니다. deal edit --stage 대신 deal move를 사용하세요.

수정 / 삭제

crm deal edit dl_01... --value 75000 --add-contact [email protected] --probability 80
crm deal rm dl_01... --force

파이프라인 개요

crm pipeline

단계별 개수, 총 가치 및 가중치 가치를 표시합니다.

활동 로깅

활동 로깅

crm log note "Had coffee with Jane, discussed Q3 expansion" --contact [email protected]
crm log call "Demoed product, she wants a proposal" --contact [email protected] --deal dl_01...
crm log meeting "Quarterly review" --company acme.com --at 2026-04-01
crm log email "Sent follow-up pricing" --contact [email protected] --set channel=outbound

유형: note, call, meeting, email. 연락처와 회사는 자동 생성됩니다. --contact는 반복 사용 가능합니다. --at는 타임스탬프를 재정의합니다.

활동 목록

crm activity list --contact [email protected] --since 2026-01-01
crm activity list --type call --limit 10
crm activity list --deal dl_01... --format json

태그

crm tag [email protected] hot-lead enterprise      # 태그 추가
crm untag [email protected] old-tag                 # 태그 제거
crm tag list                                     # 모든 태그와 개수
crm tag list --type contact                      # 연락처 태그만

태그는 연락처, 회사, 거래에 사용할 수 있습니다.

검색

정확한 키워드 검색 (FTS5)

crm search "acme CTO"
crm search "jane" --type contact

퍼지 / 의미 검색

crm find "fintech startup London"
crm find "that CTO I met at the conference" --limit 5 --threshold 0.3

검색 인덱스 재구축

crm index rebuild
crm index status

인덱스는 쓰기 시 자동 업데이트됩니다. 손상 후에만 수동 재구축이 필요합니다.

중복 탐지

crm dupes
crm dupes --type contact --threshold 0.5
crm dupes --type company --limit 20

Levenshtein + Dice 계수 유사도를 결합하여 사용합니다. 다음을 탐지: 유사한 이름, 공유 이메일, 공유 전화번호, 공유 웹사이트, 공유 소셜 핸들. 검토 후 병합:

crm dupes --type contact
# → Jane Doe ↔ J. Doe: 유사한 이름, 공유 이메일
crm contact merge ct_01A... ct_01B...

보고서

crm report pipeline                                  # 단계별 개수 및 가치
crm report activity --period 30d --by type           # 활동량
crm report stale --days 14 --type contact            # 최근 활동 없음
crm report conversion --since 2026-01-01             # 단계 간 전환율
crm report velocity --won-only                       # 단계별 소요 시간
crm report forecast --period 2026-Q2                 # 가중 예측
crm report won --period 90d                          # 성사된 거래 요약
crm report lost --period 90d                         # 실패한 거래 요약

가져오기 / 내보내기

CSV 또는 JSON에서 가져오기

crm import contacts leads.csv
crm import contacts leads.json --update     # 이메일 일치로 기존 업데이트
crm import companies companies.csv --dry-run
crm import deals deals.csv --skip-errors
cat data.json | crm import contacts -        # stdin에서 가져오기

CSV 헤더: name, email/emails, phone/phones, company/companies, tags, linkedin, x, bluesky, telegram. 인식되지 않는 열은 사용자 정의 필드가 됩니다.

내보내기

crm export contacts --format csv > contacts.csv
crm export companies --format json > companies.json
crm export deals --format tsv
crm export all --format json > full-backup.json

가상 파일 시스템 (마운트)

CRM을 라이브 읽기/쓰기 파일 시스템으로 마운트합니다. 파일을 읽는 모든 도구가 전체 CRM에 접근 가능 — AI 에이전트, grep, jq, vim, 스크립트 등.

마운트

crm mount ~/crm
crm mount ~/crm --readonly

Linux에서는 FUSE를 사용합니다. macOS에서는 NFS v3 서버를 사용합니다 (커널 확장 불필요).

파일 시스템 레이아웃

~/crm/
├── llm.txt                           # AI 에이전트용 지침
├── contacts/
│   ├── ct_01...jane-doe.json         # 연락처 JSON 파일
│   ├── _by-email/                    # 이메일별 조회
│   ├── _by-phone/                    # E.164 전화번호별 조회
│   ├── _by-linkedin/                 # LinkedIn 핸들별 조회
│   ├── _by-x/                        # X 핸들별 조회
│   ├── _by-company/                  # 회사별 그룹화
│   └── _by-tag/                      # 태그별 그룹화
├── companies/
│   ├── co_01...acme-corp.json
│   ├── _by-website/
│   ├── _by-phone/
│   └── _by-tag/
├── deals/
│   ├── dl_01...acme-enterprise.json
│   ├── _by-stage/
│   ├── _by-company/
│   └── _by-tag/
├── activities/
│   ├── _by-contact/
│   ├── _by-company/
│   ├── _by-deal/
│   └── _by-type/
├── reports/                          # 사전 계산된 분석
│   ├── pipeline.json
│   ├── forecast.json
│   ├── stale.json
│   ├── conversion.json
│   ├── velocity.json
│   ├── won.json
│   └── lost.json
├── pipeline.json                     # 빠른 파이프라인 개요
├── tags.json                         # 모든 태그와 개수
└── search/                           # 파일 읽기로 검색
    └── <query>.json                  # cat search/"acme CTO".json

파일 시스템을 통한 읽기

ls ~/crm/contacts/
cat ~/crm/contacts/ct_01...jane-doe.json | jq .
cat ~/crm/contacts/_by-email/[email protected]
cat ~/crm/deals/_by-stage/qualified/
cat ~/crm/reports/forecast.json
cat ~/crm/search/"enterprise deals".json

파일 시스템을 통한 쓰기

# 연락처 생성
echo '{"name":"Bob Smith","emails":["[email protected]"]}' > ~/crm/contacts/new.json

# 업데이트 (읽기 → 수정 → 다시 쓰기)
cat ~/crm/contacts/ct_01...jane-doe.json | jq '.tags += ["vip"]' > ~/crm/contacts/ct_01...jane-doe.json

# 삭제
rm ~/crm/contacts/ct_01...jane-doe.json

마운트 해제

crm unmount ~/crm

정적 내보내기 (마운트 불필요)

crm export-fs ./crm-snapshot

FUSE를 사용할 수 없는 컨테이너나 샌드박스에서 유용한 정적 복사본으로 동일한 디렉터리 구조를 내보냅니다.

대량 작업

--format ids를 사용하여 다른 명령어로 파이프:

# Acme의 모든 연락처를 enterprise로 태그
crm contact list --company "Acme Corp" --format ids | xargs -I{} crm tag {} enterprise

# $50k 이상의 모든 qualified 거래를 proposal로 이동
crm deal list --stage qualified --min-value 50000 --format ids | \
  xargs -I{} crm deal move {} --stage proposal

# 모든 오래된 연락처 삭제
crm report stale --days 90 --type contact --format ids | xargs -I{} crm contact rm {} --force

사용자 정의 필드

모든 엔티티는 임의의 키-값 필드를 지원합니다:

crm contact add --name "Jane" --set title=CTO --set source=conference
crm contact edit [email protected] --set "json:score=85" --set "json:verified=true"
crm contact edit [email protected] --unset source
crm contact list --filter "title~=CTO"

타입이 있는 값(숫자, 불리언, 배열)을 위해 json: 접두사를 사용하세요.

훅

crm.toml에서 변경 시 실행되는 셸 훅을 설정합니다:

[hooks]
post-contact-add = "~/.crm/hooks/notify-slack.sh"
post-deal-stage-change = "~/.crm/hooks/deal-moved.sh"
pre-contact-rm = "~/.crm/hooks/confirm-delete.sh"

엔티티 데이터는 stdin으로 JSON으로 전달됩니다. 사전 훅은 0이 아닌 종료 코드 시 중단됩니다.

사용 가능한 훅: {pre,post}-{contact,company,deal}-{add,edit,rm}, {pre,post}-deal-stage-change, {pre,post}-activity-add.

AI 에이전트를 위한 팁

  • 마운트 우선: crm mount ~/crm으로 파일 시스템 접근 — CLI 명령어 대신 JSON 파일을 직접 읽으세요
  • llm.txt 읽기: 마운트 지점에는 구조 문서와 팁이 있는 llm.txt가 있습니다
  • _by-* 디렉터리 사용 빠른 조회: _by-email, _by-phone, _by-linkedin, _by-tag, _by-stage
  • --format json 사용 모든 CLI 출력을 프로그래밍 방식으로 처리할 때
  • --format ids + xargs 사용 대량 작업 시
  • reports/ 읽기 사전 계산된 분석용 — 원시 데이터에서 다시 계산하지 마세요
  • 파일 시스템으로 검색: cat ~/crm/search/"your query".json
  • 파일 시스템으로 쓰기: JSON 파일을 작성하여 엔티티 생성/업데이트
  • 모든 JSON 파일은 자체 포함 — 파일 간 조인 불필요
  • 전화번호 입력 시 모든 형식 허용; 내부적으로 E.164로 저장
  • 소셜 핸들 전체 URL 허용; 정리된 핸들로 저장됨

관련 스킬