Solo CLI

A terminal-based user interface for SOLO.ro, an online accounting platform for Romanian freelancers (PFA).

Features

• 🔐 Secure authentication with SOLO.ro
• 📊 Dashboard with company info and yearly summary
• 💰 View revenues and expenses
• 📄 View e-Factura (national electronic invoicing system)
• 📤 Upload expense documents (PDF, Images)
• 🗑️ Delete expenses/queued documents
• 🍪 Cookie persistence for faster logins

Installation

macOS (Homebrew)

brew install rursache/tap/solo-cli

Windows / Linux / macOS (Go)

go install github.com/rursache/solo-cli@latest

Build from Source

git clone https://github.com/rursache/solo-cli.git
cd solo-cli
go build -o solo-cli .

Screenshots

Configuration

On first run, the CLI creates a config at ~/.config/solo-cli/config.json:

{
  "username": "your_email@example.com",
  "password": "your_password",
  "company_id": "your_company_id",
  "page_size": 100,
  "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36..."
}

Field	Required	Description
username	Yes	SOLO.ro login email
password	Yes	SOLO.ro password
company_id	No	Company ID for profile display
page_size	No	Number of items to fetch (default: 100)
user_agent	No	Custom HTTP user agent string

Finding Your Company ID

1. Log in to SOLO.ro
2. Go to Settings → Company: https://falcon.solo.ro/settings#!/company
3. Open browser DevTools (F12) → Network tab
4. Type company_ in the filter box
5. Look for a request like company_0e5f5310aec44ea7ba27025d2fd7551c
6. Copy the ID part (the 32 characters after company_)

Usage

Interactive TUI Mode

solo-cli

Navigate with keyboard:

• Tab / ← → - Switch between tabs
• ↑ ↓ / j k - Navigate lists
• d - Delete item (Queue tab only)
• r - Refresh data
• q - Quit

Tabs: Dashboard → Revenues → Expenses → e-Factura → Queue

CLI Commands

solo-cli summary          # Account summary (current year)
solo-cli summary 2025     # Summary for specific year
solo-cli revenues         # List revenues (alias: rev)
solo-cli expenses         # List expenses (alias: exp)
solo-cli efactura         # e-Factura documents (alias: ei)
solo-cli queue            # Expense queue (alias: q)
solo-cli company          # Company profile
solo-cli upload file.pdf  # Upload expense document (alias: up)
solo-cli queue delete 123 # Delete queued item by ID

Global Options

solo-cli --help           # Show help
solo-cli --version        # Show version
solo-cli -c /path/to/config.json summary  # Use custom config

Examples

# Pipe to grep
solo-cli expenses | grep -i "food"

# Use custom config
solo-cli -c ~/work.json revenues

# View past year
solo-cli summary 2024

Output is tab-separated for piping to other tools.

AI Skills

This project also provides a "skill" for agentic AI tools, allowing AI assistants to interact with SOLO.ro on your behalf:

• GitHub: skill folder
• ClawdHub: rursache/solo-cli

Acknowledgments

This entire codebase was created using Claude Opus 4.5. Issues and PRs are welcome.

License

MIT License - see LICENSE for details