# Revenue goal

Posts in Slack the first time this period's Stripe revenue passes your goal.

Requires Stripe, through Composio. Requires Slack, through Composio. Runs on a schedule.

## Install

No one has run this against real Stripe and Slack accounts through Composio yet. Its eval cases use stand-ins.

```sh
npx @parcha/agentrun template install github:Parcha-ai/agentrun-templates/templates/revenue-goal@242f29da8317fbe51d0cce4628bdb5ab61d7ccc9 --trust
```

Or open `<your AgentRun address>/#/templates/install?src=github%3AParcha-ai%2Fagentrun-templates%2Ftemplates%2Frevenue-goal%40242f29da8317fbe51d0cce4628bdb5ab61d7ccc9`. Pinned to commit 242f29da8317fbe51d0cce4628bdb5ab61d7ccc9.

## What it does

Checks your Stripe revenue every hour and posts one celebration in Slack the first time this month's (or quarter's, or year's) collected revenue passes the goal you set. It adds up the period from Stripe's balance transactions (charges and payments, less refunds, before fees) and posts once per goal and period, never twice. It only reads Stripe. It posts on its own only if you pick Never for approvals at install; it stays held to your channel either way.

- Skill `revenue-goal`: Add up the current period's collected revenue from Stripe's balance transactions and post one Slack celebration when it first passes the goal, once per goal and period. Reads Stripe only; the one write is the pinned Slack post. Use for the hourly check and for "are we past the goal".

## What starts it

- On a schedule: on the cron line 0 * * * * (UTC), unless you pick another time when you install it.
- By hand, any time: from the console, the API or the CLI.

## Inputs

| Name | Type | Required | What it is |
| --- | --- | --- | --- |
| `as_of` | string, date-time | no | Check the period that holds this moment, by hand. Blank: now. Example: `2026-11-18T15:00:00Z`. |

### Setup, filled in once at install

| Name | Type | Required | What it is |
| --- | --- | --- | --- |
| `goal_amount` | number | yes | The revenue goal for each period, in whole currency units (100000 for $100,000), counted before Stripe's fees and after refunds. |
| `currency` | string | no | The currency the goal is in, as Stripe writes it (usd, eur, gbp); only money moved in this currency counts, nothing is converted. Default: `usd`. |
| `period` | string, one of month, quarter, year | no | The period the goal is for: month, quarter or year; it starts over at the start of each. Default: `month`. |
| `timezone` | string, timezone | no | The IANA time zone your periods start in and the cron line is read in (America/New\_York): UTC unless you set it. Default: `UTC`. |
| `cron` | string, cron | no | When the check runs, as a cron line (minute hour day-of-month month day-of-week): every hour on the hour unless you set it. Default: `0 * * * *`. |
| `channel` | string | yes | The Slack channel ID the celebration goes to, like C0123ABCD (in Slack: the channel's details, at the bottom). Not a #name. |

## What it needs

- Harness: pi, claude-agent, codex
- Model: balanced tier, low effort
- Tools: read
- Composio Stripe tools: STRIPE_LIST_BALANCE_TRANSACTIONS, STRIPE_SEARCH_CHARGES. Reads your Stripe balance transactions and charges to add up the period's revenue. It reads only: no refund, no charge, no change to any customer.
- Composio Slack tools: SLACK_SEND_MESSAGE. Posts one message when the goal is reached, to the one Slack channel you set, and nowhere else.
- Computer: Wherever your AgentRun puts a new agent
- Keys: A model key
- Learning: on

## Sample output

Input:

```json
{
  "content": "Scheduled run. Add up the period's revenue and check it against the goal with your revenue-goal skill."
}
```

Output:

Illustrative output, written by hand from the `crosses-goal` eval case's test account. A measured eval run replaces it.

The 15:00 check on 2026-11-18 found November at $101,240.50, past the $100,000 goal, and one message went to the
revenue channel. The total counts four charges and one payment, less a $1,500 refund. A payout, a Stripe fee and an
October charge came back in the same list and were left out.

> :tada: *We passed $100,000.00 in November 2026.*
> Collected so far: $101,240.50 (charges and payments less refunds, before Stripe fees), as of 2026-11-18.

## Tested

Passes 5 of 5 eval cases on pi, 5 of 5 on Claude Code and 5 of 5 on Codex.

5 eval cases: below-goal, crosses-goal, injection-in-charge, no-repeats, other-currency.

## Source

- Package: https://github.com/Parcha-ai/agentrun-templates/tree/242f29da8317fbe51d0cce4628bdb5ab61d7ccc9/templates/revenue-goal
- Publisher: Parcha-ai
- Author: Parcha Labs
- Version: 0.1.0
- License: Apache-2.0
- Category: Finance
- Page: https://marketplace.agentrun.ai/templates/revenue-goal/
