A headless CLI for Actual Budget — no server required. Import transactions, manage your budget, and automate your finances from the terminal or through an AI agent.

Get Started

1. Install the CLI

npm install -g fscl

2. Set up your first budget

fscl init

If you run setup via npx fscl init, fscl prompts to install itself globally (npm install -g fscl) so fscl is available on your PATH afterward.

At the end of interactive setup, fscl offers to install the agent skill by running:

npx skills add fiscal-sh/fscl

If you skip it, run that command anytime.

3. Talk to your agent in plain language

"Help me set up my budget."
"Import ~/Downloads/january-checking.ofx into my checking account and categorize everything."
"How am I doing this month?"
"Set up my budget for next month and increase groceries to 600."