> ## Documentation Index
> Fetch the complete documentation index at: https://help.checkrmoney.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Checkr Money CLI

> Query your Checkr Money financial data from the terminal.

## What is Checkr Money CLI?

Checkr Money CLI is a command-line tool for accessing your Checkr Money financial data from the terminal. Check balances, pull transactions, review income, and analyze spending without leaving the shell. It authenticates via browser-based OAuth - no API keys or tokens to manage.

The project is open source at [github.com/truvhq/mytruv-cli](https://github.com/truvhq/mytruv-cli).

<Info>
  The CLI is **read-only**. It cannot modify your accounts, create transactions, or change any settings.
</Info>

<Tip>
  Already signed in to Checkr Money? Find this and the other AI integration links anytime from **Settings > AI Integrations** in the web app.
</Tip>

***

## Prerequisites

* **Python 3.10+**
* A Checkr Money account with at least one connected financial account

***

## Install

<Tabs>
  <Tab title="curl (recommended)">
    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/truvhq/mytruv-cli/master/scripts/install.sh | sh
    ```

    Installs to `~/.local/bin` by default. To install somewhere else, pass `INSTALL_DIR` to the piped shell:

    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/truvhq/mytruv-cli/master/scripts/install.sh | INSTALL_DIR=/usr/local/bin sh
    ```

    Linux binaries need glibc 2.35+ (Ubuntu 22.04, Debian 12, RHEL 9).
  </Tab>

  <Tab title="uv">
    ```bash theme={null}
    uv tool install git+https://github.com/truvhq/mytruv-cli.git
    ```

    Requires [uv](https://docs.astral.sh/uv/).
  </Tab>
</Tabs>

After installation, the `mytruv` command is on your `$PATH`. Startup is under 0.2 seconds on a warm cache.

To uninstall:

```bash theme={null}
rm "$(command -v mytruv)"
```

***

## Quick Start

```bash theme={null}
# 1. Log in (opens browser)
mytruv auth login

# 2. View your connected accounts
mytruv links

# 3. Check balances
mytruv balances

# 4. Pull recent transactions
mytruv transactions

# 5. Log out
mytruv auth logout
```

***

## Commands

### Authentication

| Command | Description |
| - | - |
| `mytruv auth login` | Authenticate via browser-based OAuth |
| `mytruv auth login --no-browser` | Print login URL (for headless/remote machines) |
| `mytruv auth logout` | Log out and revoke tokens |
| `mytruv auth status` | Show current authentication status (`{authenticated, user}`) |

### Financial Data

| Command | Description |
| - | - |
| `mytruv user` | Your user profile, including `lifecycle` flags (subscription, onboarding, trial) |
| `mytruv links` | Connected bank and payroll providers |
| `mytruv links report <link_id>` | Income report for a specific link (payroll or bank income) |
| `mytruv balances` | Aggregated balances by account type (`{total_accounts, accounts, aggregated_balances}`) |
| `mytruv liabilities` | Aggregated liabilities for credit cards and loans (`{accounts, liabilities}`) |
| `mytruv transactions` | Bank transactions, last 7 days by default (`--from`, `--to`, `--type`, `--account`, `--category`, `--min-amount`, `--max-amount`, `--merchant`, `--sort`, `--order`, `--page`, `--page-size`) |
| `mytruv spending` | Spending breakdown by category/merchant/time-period (`--group-by`, `--time-period`, `--days`, `--start-date`, `--end-date`) |
| `mytruv income` | Income from payroll and bank sources, each tagged with `data_source` (`--days`, default 90) |
| `mytruv recurring` | Recurring transactions (subscriptions, deposits) |
| `mytruv balance-history` | Balance trends over time (`--date-range` `1M\|3M\|6M\|1Y\|ALL`, `--time-period` `day\|week\|month`) |
| `mytruv insights` | AI-generated financial insights, rendered as title, summary, detail, and follow-up suggestions |

### Output formats

Every data command accepts:

| Flag | Behavior |
| - | - |
| `-o, --output [json\|csv]` | Force a format. Default: table on TTY, JSON when piped. |
| `--json` | Shorthand for `--output json`. |
| `--no-color` | Disable ANSI colors (useful in CI). |

CSV output formats currency as strings (e.g. `"$1,234.56"`). For raw numbers, use JSON. `--output csv` on `transactions` streams directly from the server and supports up to 10,000 rows per export.

### MCP Server

| Command | Description |
| - | - |
| `mytruv mcp` | Start an MCP stdio server for local AI agent integration |

See [Agent & Automation](/mytruv-cli/agent-automation) for the Gemini CLI extension setup.

### Shell Completion

| Command | Description |
| - | - |
| `mytruv completion bash` | Print bash completion script |
| `mytruv completion zsh` | Print zsh completion script |
| `mytruv completion fish` | Print fish completion script |

Add to your shell config:

```bash theme={null}
# bash (~/.bashrc)
source <(mytruv completion bash)

# zsh (~/.zshrc)
source <(mytruv completion zsh)

# fish (~/.config/fish/config.fish)
mytruv completion fish | source
```

### Global flags

| Flag | Behavior |
| - | - |
| `--version` | Print the installed CLI version and exit |
| `--help` | Show help for `mytruv` or any subcommand |

### Environment variables

| Variable | Description |
| - | - |
| `MYTRUV_CONFIG_DIR` | Directory for config and stored credentials. Default: `~/.config/mytruv`. |
| `NO_COLOR` | Set to any value to disable ANSI colors (same as `--no-color`). |
| `NUITKA_ONEFILE_TEMPDIR` | Override where the self-contained binary unpacks on first run (useful when `$HOME` is read-only). |
| `MYTRUV_VERSION` | Pin the version the install script downloads (install-time only). |

***

## Next steps

<CardGroup cols={2}>
  <Card title="Agent & Automation" icon="robot" href="/mytruv-cli/agent-automation">
    JSON output, exit codes, MCP stdio mode, Gemini extension
  </Card>

  <Card title="Checkr Money MCP" icon="plug" href="/mytruv-mcp/overview">
    Hosted MCP server for remote AI assistants
  </Card>

  <Card title="GitHub Repo" icon="github" href="https://github.com/truvhq/mytruv-cli">
    Source, issues, and release notes
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/overview">
    REST API for programmatic access
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.