# Use Case Library

#### How to Use This Library

Each use case includes:

* **The complete script** you can copy and run
* **How to customize** it for your needs
* **What it outputs** so you know what to expect

All scripts assume you've already [installed and authenticated Kick CLI](/ai/developer-tools/cli/install-the-kick-cli.md).

***

### Workflow Scripts by Use Case

<table data-view="cards"><thead><tr><th data-type="content-ref"></th></tr></thead><tbody><tr><td><a href="/pages/Bt0dZtinhGbcuj9m33oh">/pages/Bt0dZtinhGbcuj9m33oh</a></td></tr><tr><td><a href="/pages/6QXixcv8B6TR5NFMZsNc">/pages/6QXixcv8B6TR5NFMZsNc</a></td></tr><tr><td><a href="/pages/Uge0kltWzlgtiKmlnuKc">/pages/Uge0kltWzlgtiKmlnuKc</a></td></tr><tr><td><a href="/pages/lrI0QxMMLj6Y5qEw2upP">/pages/lrI0QxMMLj6Y5qEw2upP</a></td></tr><tr><td><a href="/pages/1v3vNAhzZBjreZGCBTo7">/pages/1v3vNAhzZBjreZGCBTo7</a></td></tr><tr><td><a href="/pages/j9GuZiYISQY5b9Mt1HzH">/pages/j9GuZiYISQY5b9Mt1HzH</a></td></tr></tbody></table>

***

#### Quick Command Reference

<details>

<summary><strong>List workspaces</strong></summary>

bash

```bash
kick workspaces list
```

</details>

<details>

<summary>S<strong>et active workspace</strong></summary>

bash

```bash
kick workspace set "Client Name"
```

</details>

<details>

<summary><strong>List entities in workspace</strong></summary>

bash

```bash
kick entities list
```

</details>

<details>

<summary><strong>Show recent transactions</strong></summary>

bash

```bash
kick transactions list --limit=20
```

</details>

<details>

<summary><strong>Filter by date range</strong></summary>

bash

```bash
kick transactions list --from="2026-01-01" --to="2026-01-31"
```

</details>

<details>

<summary><strong>Filter by amount</strong></summary>

bash

```bash
kick transactions list --min-amount=5000
```

</details>

<details>

<summary><strong>Export to CSV</strong></summary>

bash

```bash
kick transactions list --format=csv > transactions.csv
```

</details>

<details>

<summary><strong>Profit &#x26; Loss</strong></summary>

bash

```bash
kick reports pl --entity="ACME Corp" --period="2026-01"
```

</details>

<details>

<summary><strong>Balance Sheet</strong></summary>

bash

```bash
kick reports trial-balance --entity="ACME Corp" --period="2026-Q1"
```

</details>

<details>

<summary><strong>Trial Balance</strong></summary>

bash

```bash
kick reports trial-balance --entity="ACME Corp" --period="2026-Q1"
```

</details>

<details>

<summary><strong>Export to JSON</strong></summary>

bash

```bash
kick reports pl --entity="ACME Corp" --period="2026-01" --format=json > pl-jan.json
```

</details>

<details>

<summary><strong>List existing rules</strong></summary>

bash

```bash
kick rules list
```

</details>

<details>

<summary><strong>Create a categorization rule</strong></summary>

bash

```bash
kick rules create \
  --name="AWS Cloud Expenses" \
  --condition="description contains 'AWS'" \
  --action="set-category:Cloud Infrastructure"
```

</details>

<details>

<summary><strong>Test a rule before creating</strong></summary>

bash

```bash
kick rules test \
  --condition="description contains 'AWS'" \
  --preview=10
```

</details>

<details>

<summary><strong>Delete a rule</strong></summary>

bash

```bash
kick rules delete --id=rule_abc123
```

</details>

<details>

<summary><strong>Update transactions from CSV</strong></summary>

bash

```bash
kick transactions update --file=updates.csv
```

</details>

<details>

<summary><strong>Bulk categorize</strong></summary>

bash

```bash
kick transactions categorize \
  --filter="counterparty=Amazon" \
  --category="Office Supplies"
```

</details>

<details>

<summary><strong>Preview before executing</strong></summary>

bash

```bash
kick transactions categorize \
  --filter="counterparty=Amazon" \
  --category="Office Supplies" \
  --dry-run
```

</details>

***

**Have a workflow you'd like to automate?** Share it with us and we'll add it to this library at <support@kick.co>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kick.co/ai/kick-cli/cli-use-case-library.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
