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 허용; 정리된 핸들로 저장됨