Package Exports
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@opes-app/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
@opes-app/cli
AI-powered financial CLI for the Opes platform. Manage your finances directly from the terminal with natural language commands.
Features
- AI Chat Interface - Ask questions about your finances in natural language
- Interactive Mode - Full-featured terminal UI powered by Ink
- One-shot Commands - Quick queries without entering interactive mode
- Secure Authentication - OAuth-based login with secure credential storage
Requirements
- Node.js >= 18.17.0
- An Opes account
Installation
npm install -g @opes-app/cliOr with yarn:
yarn global add @opes-app/cliOr with pnpm:
pnpm add -g @opes-app/cliUsage
Authentication
First, authenticate with your Opes account:
opes loginThis will open a browser window for OAuth authentication. Your credentials are stored securely in your system's config directory.
To log out and clear stored credentials:
opes logoutChat with AI
Interactive mode - Start a chat session:
opesOne-shot mode - Ask a single question:
opes "What's my spending this month?"opes "Show my account balances"opes "How much did I spend on groceries?"Help
opes --helpCommands
| Command | Description |
|---|---|
opes |
Start interactive AI chat |
opes [message] |
Send a one-shot message to AI |
opes login |
Authenticate with Opes |
opes logout |
Clear stored credentials |
opes --version |
Show version |
opes --help |
Show help |
Configuration
Credentials are stored in your system's config directory:
- macOS:
~/Library/Preferences/opes-cli-nodejs/ - Linux:
~/.config/opes-cli-nodejs/ - Windows:
%APPDATA%/opes-cli-nodejs/
Development
# Clone the repository
git clone https://github.com/opes-app/opes.git
cd opes/apps/cli
# Install dependencies
npm install
# Run in development mode
npm run dev
# Build
npm run build
# Run tests
npm testLicense
MIT - see LICENSE for details.