Skip to content

Expose financial insights CLI commands and skill file - #240

Merged
selinafeng-stripe merged 4 commits into
mainfrom
selinafeng/expose-fi-cli-commands
Aug 12, 2026
Merged

Expose financial insights CLI commands and skill file#240
selinafeng-stripe merged 4 commits into
mainfrom
selinafeng/expose-fi-cli-commands

Conversation

@selinafeng-stripe

Copy link
Copy Markdown
Contributor

Summary

  • Exposes financial insights CLI commands (transactions, balances, sources) as regular CLI commands instead of hidden
  • Enables showing help menus for financial insights commands (tags commands as beta in description text)
  • Adds the financial insights skill file
  • Callers must still be enrolled as testers to use these commands

Testing

link-cli skills list

...
✓ financial-insights         Reads a user's Link financial data — transactions, balances, and wallet sources — so agents can answer questions about spending and available source capabilities.
...
link-cli --help

Usage: link-cli <command>

Commands:
  ...
  balances          [beta] List balances from your Link wallet
  sources           [beta] List sources from your Link wallet
  transactions      [beta] List transactions from Link and external accounts
link-cli transactions --help

Usage: link-cli transactions <command>

Commands:
  list  List transactions from Link and external accounts, including non-Link activity

Global Options:
  --filter-output <keys>              Filter output by key paths (e.g. foo,bar.baz,a[0,3])
  --format <toon|json|yaml|md|jsonl>  Output format
  --full-output                       Show full output envelope
  --help                              Show help
  --llms, --llms-full                 Print LLM-readable manifest
  --schema                            Show JSON Schema for command
  --token-count                       Print token count of output (instead of output)
  --token-limit <n>                   Limit output to n tokens
  --token-offset <n>                  Skip first n tokens of output

@selinafeng-stripe
selinafeng-stripe requested a review from a team as a code owner August 11, 2026 04:47
@ghost

ghost commented Aug 11, 2026

Copy link
Copy Markdown

Run pnpm turbo run test
pnpm turbo run test
shell: /usr/bin/bash -e {0}
env:
PNPM_HOME: /home/runner/setup-pnpm/node_modules/.bin
• Packages in scope: @stripe/link-cli, @stripe/link-sdk, @stripe/link-typescript-config
• Running test in 3 packages
• Remote caching disabled
@stripe/link-sdk:build
@stripe/link-cli:build
@stripe/link-sdk:test

@ghost

ghost commented Aug 11, 2026

Copy link
Copy Markdown

link-cli skills list

...
✓ financial-insights Reads a user's Link financial data — transactions, balances, and wallet sources — so agents can answer questions about spending and available source capabilities.
...

@ghost

ghost commented Aug 11, 2026

Copy link
Copy Markdown

link-cli --help

Usage: link-cli

Commands:
...
balances [beta] List balances from your Link wallet
sources [beta] List sources from your Link wallet
transactions [beta] List transactions from Link and external accounts

@ghost

ghost commented Aug 11, 2026

Copy link
Copy Markdown

link-cli transactions --help

Usage: link-cli transactions

Commands:
list List transactions from Link and external accounts, including non-Link activity

Global Options:
--filter-output Filter output by key paths (e.g. foo,bar.baz,a[0,3])
--format <toon|json|yaml|md|jsonl> Output format
--full-output Show full output envelope
--help Show help
--llms, --llms-full Print LLM-readable manifest
--schema Show JSON Schema for command
--token-count Print token count of output (instead of output)
--token-limit Limit output to n tokens
--token-offset Skip first n tokens of output

Comment thread packages/cli/src/cli.tsx
const authRepo = factory.createAuthResource();
const spendRequestRepo = factory.createSpendRequestResource();

const requestedCommand = process.argv[2];

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

<3

Comment thread packages/cli/src/cli.tsx
'Create a secure, one-time payment credential from a Link wallet to let agents complete purchases on behalf of users.',
version: cliVersion,
sync: {
include: ['skills/*'],

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the create-payment-credential was not being included in skills list either, and this change updates that. @jlau-stripe was that intentional/is this okay?

Comment thread skills/financial-insights/SKILL.md Outdated
@@ -0,0 +1,291 @@
---
version: 0.6.0

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ensure that the build commands update this

Comment thread skills/financial-insights/SKILL.md Outdated
Reads a user's Link financial data — transactions, balances, and wallet sources — so agents can answer questions about spending and available source capabilities.
allowed-tools:
- Bash(link-cli:*)
- Bash(npx:*)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@kreese-stripe didn't we remove this from the other skill?

Comment thread skills/financial-insights/SKILL.md Outdated
version: 0.6.0
name: financial-insights
description: |
Reads a user's Link financial data — transactions, balances, and wallet sources — so agents can answer questions about spending and available source capabilities.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add a "when to use" line

@selinafeng-stripe
selinafeng-stripe merged commit c3e70e1 into main Aug 12, 2026
5 checks passed
@selinafeng-stripe
selinafeng-stripe deleted the selinafeng/expose-fi-cli-commands branch August 12, 2026 13:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants