기술 창업자, 개발자, 에이전트 빌더를 위한

AI 에이전트에 원장을 부여하세요

bea 명령줄 도구를 설치한 다음, 이미 사용 중인 셸 지원 AI 에이전트에 하나의 작업을 붙여넣으세요. 몇 분 후에 검증된 로컬 원장을 돌려받습니다 — Beancount.io 계정이 필요하지 않습니다.

bea 설치

동일한 명령어를 얻을 수 있는 두 가지 공식 방법이 있습니다. 사용자 머신에 맞는 방법을 선택한 다음, 버전으로 응답하는지 확인하세요.

uv 사용 (Python 3.12 이상이 설치된 모든 환경)

uv tool install beancount-io

Homebrew 사용 (macOS 또는 Linux)

brew install bex-co/tap/bea

bea --version

bea 0.1.0으로 검증된 예: Python 배포판은 beancount-io이고 설치되는 실행 파일은 bea입니다.

필요한 것

터미널, 네트워크 연결, 그리고 Python 3.12 이상이 포함된 Homebrew 또는 uv가 필요합니다. 로컬 부기에는 Beancount.io 계정이 필요하지 않습니다 — 계정은 아래의 선택적 호스팅 단계에서만 필요합니다.

장부는 사용자 머신에 유지됩니다

아래의 모든 명령어는 사용자가 선택한 디렉터리의 일반 텍스트 .bean 파일에서 작동합니다. 새 원장 파일은 사용자에게 비공개이며, 각 추가 사항은 파일이 교체되기 전에 전체 원장에 대해 검증됩니다 — 기본 로컬 CLI 경로에서는 알 수 없는 계정이나 불균형 거래는 안내와 함께 오류로 처리되고 파일은 변경되지 않습니다.

에이전트의 첫 번째 작업

이 내용을 에이전트에 붙여넣으세요. 1,000 USD의 당좌예금으로 시작하여 12.50 USD 커피를 기록하고, 원장을 검증한 후 사용한 쿼리와 함께 잔액을 보고합니다.

에이전트 작업 프롬프트

You have shell access and the `bea` CLI installed. First run `bea --help` and read what it offers. Then, in a NEW empty demo directory (do not touch any existing ledger): 1) create a USD ledger opening Assets:Checking at 1000 on 2026-08-01; 2) add a 12.50 USD purchase narrated "Coffee" to Expenses:Dining on 2026-08-02; 3) run `bea check`; 4) report the Assets:Checking balance together with the exact BQL query you used. Expected result: 987.50 USD.

일반 명령어로 동일한 단계

bea --no-input init demo-books --currency USD --date 2026-08-01 --opening-balance "Assets:Checking 1000"
cd demo-books
bea add transaction --date 2026-08-02 --narration "Coffee" --posting "Expenses:Dining 12.50" --posting "Assets:Checking"
bea check
bea query "SELECT account, sum(position) WHERE account = 'Assets:Checking' GROUP BY account"

예상 결과: Assets:Checking에는 987.50 USD가 있습니다.

CLI 빠른 시작 읽기

선택 사항: 호스팅 AI 도움

위의 어떤 것도 계정이 필요하지 않으며 원장을 어디로도 보내지 않습니다. 두 가지 선택적 추가 기능에는 계정이 필요하며, 둘 다 CLI 설치와는 별개입니다.

bea ask는 호스팅 AI 서비스를 통해 로컬 원장에 대한 질문에 답합니다. ask 확장 기능 — uv tool install 'beancount-io[ask]' — 과 Beancount.io 자격 증명이 필요합니다.

MCP 서버와 호스팅 원장도 마찬가지로 Beancount.io 계정으로 로그인하여 액세스를 승인합니다. 로컬에서 시작하고, 원한다면 호스팅을 연결하세요.

Beancount용 에이전트 스킬은 제품 저장소에 있으며 별도로 에이전트에 로드됩니다 — CLI를 설치해도 스킬이 설치되거나 구성되지 않습니다.

에이전트 빌더가 묻는 질문

Beancount.io 계정이 필요한가요?

이 페이지의 어떤 것에도 필요하지 않습니다. bea 설치, 로컬 원장 생성, 구매 기록, 잔액 확인은 모두 계정 없이 작동합니다. 선택적 호스팅 추가 기능(bea ask, MCP 서버, 호스팅 원장)에만 로그인이 필요합니다.

CLI를 설치하면 AI 에이전트가 설정되나요?

아니요. 설치하면 bea 명령어가 제공되며, 에이전트는 그대로 유지됩니다. 사용 중인 셸 지원 에이전트에 위의 작업을 붙여넣고, 에이전트 스킬 로드는 별도의 단계입니다.

원장이 내 머신을 벗어나나요?

로컬 명령어는 로컬 .bean 파일에서 작동하며 네트워크 호출을 하지 않습니다. 호스팅 명령어(bea cloud 및 bea ask, 모델 호출이 호스팅 AI 프록시를 통해 실행됨)만 Beancount.io 서비스와 통신합니다.

에이전트가 잘못된 항목을 작성하면 어떻게 되나요?

기본 로컬 CLI 경로에서는 모든 추가 사항이 파일 교체 전에 전체 원장에 대해 검사됩니다. 알 수 없는 계정이나 불균형 거래는 안내와 함께 실패하고 파일을 변경하지 않습니다 — 수동 편집 후에도 에이전트가 bea check를 실행하도록 하세요.

bea ask에 정확히 무엇이 필요한가요?

이 페이지 외에 두 가지가 필요합니다: ask 종속성 확장 기능과 로그인할 호스팅 자격 증명입니다. 기본 bea 설치에는 요청할 때까지 AI 종속성이 의도적으로 포함되지 않습니다.

커피로 시작하고, 장부로 계속하세요

한 번의 설치, 한 번의 붙여넣기 작업, 하나의 검증된 잔액 — 그런 다음 전체 빠른 시작을 계속하세요.

CLI 빠른 시작 읽기