AI 에이전트에 원장을 부여하세요
작업을 검토 가능한 장부로 바꾸세요. 셸 지원 에이전트에 bea CLI를 제공하여 거래를 기록하고 작업을 확인하고, plain text로 뒷받침되는 잔액을 반환하세요.
bea 설치
설치 프로그램을 선택한 다음 버전을 확인하세요. 로컬 장부에는 Beancount.io 계정이 필요하지 않습니다.
uv · Python 3.12+
uv tool install beancount-ioHomebrew · macOS 또는 Linux
brew install bex-co/tap/bea
2026-08-02 * "Coffee"
Expenses:Dining 12.50 USD
Assets:Checking -12.50 USDPlain text. 당신의 것이 됩니다.
Git으로 읽고, 비교하고, 버전 관리할 수 있는 로컬 .bean 파일.
모든 변경 전에 확인.
기본 CLI 추가 기능은 장부가 교체되기 전에 반드시 검증되어야 합니다.
사용 중인 에이전트를 가져오세요.
셸 지원 에이전트, 하나의 작업, 그리고 검토할 수 있는 명령어.
필요한 것
터미널, 네트워크 연결, 그리고 Python 3.12 이상이 있는 Homebrew 또는 uv가 필요합니다. 로컬 회계에는 Beancount.io 계정이 필요하지 않습니다 — 계정은 아래의 선택적 호스팅 단계에서만 필요합니다.
bea --versionbea 0.1.0으로 검증된 예: Python 배포판은 beancount-io이고, 설치되는 실행 파일은 bea입니다.
작은 작업 하나. 실제 장부 한 벌.
1,000 USD로 시작하세요. 12.50 USD 커피를 기록하세요. 에이전트에게 장부를 확인하고 답변 뒤에 있는 쿼리를 보여달라고 요청하세요.
에이전트 작업 프롬프트
셸 액세스 권한이 있고 `bea` CLI가 설치되어 있습니다. 먼저 `bea --help`를 실행하여 제공되는 기능을 읽으세요. 그런 다음, 새로운 빈 데모 디렉토리에서(기존 원장은 건드리지 마세요): 1) 2026-08-01에 Assets:Checking을 1000으로 여는 USD 원장을 생성하세요; 2) 2026-08-02에 "Coffee"라는 내레이션으로 12.50 USD 구매를 Expenses:Dining에 추가하세요; 3) `bea check`를 실행하세요; 4) 사용한 정확한 BQL 쿼리와 함께 Assets:Checking 잔액을 보고하세요. 예상 결과: 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"에이전트를 시험해 보세요.
세 건의 은행 거래. 기록된 에이전트 실행 한 번. 동일한 입력을 다운로드하고, 결과를 재현하고, 그 과정에서 무슨 일이 있었는지 검토하세요.
기록된 실행 읽기합성 데이터, bea 0.1.0으로 검증됨. 관찰된 실행 1회; 전체 기록에는 실패와 한계가 포함됩니다.
정확한 도전 과제 입력
스타터 장부, 은행 명세서, 카테고리 규칙.
데모를 넘어 확장하세요.
위 데모를 기반으로 한 복사 가능한 레시피 두 가지: 에이전트 제안 범주로 은행 CSV를 가져오고, 쿼리 출력에서 잔액 질문에 답하세요. 각각 에이전트 프롬프트와 CLI 동등 명령 및 예상 결과를 짝지어 제공합니다.
에이전트 레시피 읽기도구를 선택하는 중이신가요? Beancount.io는 동일한 에이전트 워크플로우 기준으로 비교된 다섯 가지 도구 중 하나이며, 출처가 명시된 날짜가 포함되어 있습니다.
다섯 가지 도구 비교 읽기시작 전에 몇 가지 알아두세요.
장부는 사용자 머신에 유지됩니다
아래의 모든 명령은 사용자가 선택한 디렉토리의 일반 텍스트 .bean 파일에서 작동합니다. 새 원장 파일은 사용자만 사용할 수 있으며, 각 추가 사항은 파일이 교체되기 전에 전체 원장에 대해 검증됩니다 — 기본 로컬 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 명령어는 Beancount.io 계정 없이 작동합니다. 호스팅 AI 도움말 및 MCP 접근은 별도의 선택적 연결입니다.
bea ask는 호스팅 AI 서비스를 통해 로컬 원장에 대한 질문에 답합니다. ask 추가 기능 — uv tool install 'beancount-io[ask]' — 및 Beancount.io 자격 증명이 필요합니다.
MCP 서버 및 호스팅 원장은 마찬가지로 액세스를 승인하기 위해 Beancount.io 계정으로 로그인합니다. 로컬에서 시작하고, 원한다면 호스팅을 연결하세요.
Beancount용 에이전트 스킬은 제품 저장소에 있으며, 별도로 에이전트에 로드됩니다 — CLI를 설치해도 스킬이 설치되거나 구성되지는 않습니다.
MCP 연결 살펴보기