kakutey

CLI for the kakutey bookkeeping application.

kakutey アプリ（会計ソフト）を操作するコマンドラインツールです。仕訳の登録・一覧、証憑のアップロード・検索、財務諸表の取得などを CLI から実行できます。

Install

npm install -g kakutey-cli

Or run directly with npx:

npx kakutey-cli --help

Prerequisites

kakutey アプリが起動している必要があります（バックエンド: port 8000, フロントエンド: port 4200）。

kakutey health

Commands

health — アプリ状態確認

kakutey health

バックエンド（port 8000）とフロントエンド（port 4200）の稼働状態を確認します。

accounts — 勘定科目

# 全科目一覧
kakutey accounts list

# カテゴリでフィルタ
kakutey accounts list --category expense

--category に指定できる値: asset, liability, equity, revenue, expense

journals — 仕訳

# 仕訳一覧（期間指定）
kakutey journals list 2025-01-01 2025-12-31

# 仕訳登録（簡易形式）
kakutey journals add '{"date":"2025-01-15","description":"文房具購入","debit_account":"消耗品費","credit_account":"現金","amount":1000}'

# 仕訳登録（複合仕訳）
kakutey journals add '{"date":"2025-01-01","description":"開始仕訳","lines":[{"side":"debit","account":"現金","amount":50000},{"side":"credit","account":"元入金","amount":50000}]}'

# ファイルから登録
kakutey journals add --file journal.json

# 一括登録
kakutey journals bulk-add journals.json

# 更新（楽観ロック）
kakutey journals update '{"entity_id":1,"date":"2025-01-15","description":"修正","lines":[{"side":"debit","account":"消耗品費","amount":1500},{"side":"credit","account":"現金","amount":1500}],"expected_revision":1}'

# 削除（論理削除）
kakutey journals delete 1

# 証憑を紐付け
kakutey journals attach 1 10 20

evidence — 証憑

# アップロード
kakutey evidence upload ./receipt.pdf
kakutey evidence upload ./receipt.pdf --name "領収書 サンプル商事 2025-01"

# 検索
kakutey evidence search --name "サンプル"
kakutey evidence search --tag "交通費"

reports — 財務諸表

# 損益計算書
kakutey reports pl 2025

# 貸借対照表
kakutey reports bs 2025

# P/L + B/S 両方
kakutey reports summary 2025
kakutey reports summary 2025 --type pl

# 固定資産一覧
kakutey reports assets

# 固定資産 + 減価償却計算
kakutey reports assets --depreciation 2025

Global Options

| Option | Description | Default | |--------|-------------|---------| | --base-url <url> | API base URL | http://localhost:8000/api | | --json | Output raw JSON | off | | --version | Show version | | | --help | Show help | |

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | KAKUTEY_API_URL | API base URL | http://localhost:8000/api |

--base-url フラグは環境変数より優先されます。

License

MIT