Your financial Codexi.

A CLI ledger built in Rust. Audit-ready, tamper-proof, and designed for those who value data permanence.

Download
Get Started How it works 
$ codexi-cli search --last 2
+--------+------------+---------+----------+----------+------------+
| Id     | Date       |  Type   |    Amount|   Balance|Description |
+--------+------------+---------+----------+----------+------------+
| #GJ2YX | 2026-01-10 | Credit  |   1500.00|      2500| Salary     |
| #QFPY5 | 2026-01-12 | Debit   |     42.00|      2458| Food       |
+--------+------------+---------+----------+----------+------------+

Multi-Account

Manage several accounts and switch the active one at any time with account use.

Immutability

Anchor-based checks ensure your transaction history cannot be stealthily altered.

Archival System

Close periods formally. Codexi moves data to .cld archives while keeping your balance.

Built-in Backup

One command to zip your entire financial history and move it to secure storage.

Insightful Analytics

Don't just track numbers. Understand your behavior with a professional dashboard built directly into your terminal.

  • Savings Rate: Dynamic visualization of your monthly surplus.
  • Daily Burning Rate: Track your average daily spending at a glance.
  • Smart Filtering: Automatically hides system adjustments to focus on real habits.
  • Net Mode: Void operations are counted only when using --net, preserving historical accuracy.
Codexi Stats Dashboard

The Anchor Protocol

Unlike simple CSV trackers, Codexi relies on financial anchors to maintain a linear, auditable timeline.

INIT: Sets the genesis of your ledger. No operation can exist before it.
CLOSE: Seals a period. Archived transactions are formally locked in separate files.
ADJUST: Explicit balance correction, tracked for integrity but excluded from behavioral analytics.
Build from source
git clone https://github.com/ethal/codexi-project.git
cd codexi-project
cargo build --release

Command Manifest

Ledger Operations
Command Description Example
history init Initialize genesis balance and date. codexi-cli history init 2026-01-01 150.00
credit Add funds with description. codexi-cli credit 2026-01-10 1200.0 Salary
debit Record an expense. codexi-cli debit 2026-01-12 45.0 Grocery
search Filter and view operations. codexi-cli search --latest 10
report stats Generate the visual analytics dashboard. codexi-cli report stats --from 2026-01-01
report statement Export an HTML statement, openable in your browser. codexi report statement --from 2026-01-01 --open
Account Management
Command Description Example
account create Create a new account. codexi-cli account create 2026-01-01 My Bank
account use Switch the active account. codexi-cli account use <id>
account list List all accounts (* active, c closed). codexi-cli account list
account rename Rename an existing account. codexi-cli account rename <id> New Name
account close Close an account permanently. codexi-cli account close <id> 2026-12-31
Archival & System
history close [date]

Archives operations and seals the history with a Carry Forward entry.

admin backup

Creates a full ZIP of your ledger and archives to your Documents.

Recovery & Snapshots
data snapshot create

Instant point-in-time copy of your active ledger file.

data snapshot restore

Rollback to a previously saved .snp file safely.

reply@ethal.fr