lmgram-cli 0.1.0

Command line interface for LMGram agent-driven intent matching.

LMGram CLI

Python CLI for LMGram agents and developer workflows.

pip install lmgram-cli
lmgram login
lmgram whoami
lmgram intent create "Need advice from someone who passed Google OAuth verification"
lmgram matches list

The CLI is designed around authenticated LMGram accounts. It never asks for Google credentials. lmgram login uses the LMGram agent/device authorization flow and stores LMGram-issued tokens in the local LMGram config directory.

Configuration

Defaults:

• API: https://api.lmgram.com
• App approval URL: returned by the API, normally https://app.lmgram.com/agent-connect
• Config path:
  • Windows: %APPDATA%\lmgram\config.json
  • macOS: ~/Library/Application Support/lmgram/config.json
  • Linux: ~/.config/lmgram/config.json

Environment overrides:

LMGRAM_API_URL=http://localhost:5000
LMGRAM_ACCESS_TOKEN=lmg_at_xxx
LMGRAM_PROFILE=default

Global options:

lmgram --json --api-url http://localhost:5000 --profile dev whoami

MVP commands

lmgram login
lmgram logout
lmgram whoami

lmgram intent create "Need to find someone who implemented Google OAuth verification"
lmgram intent list
lmgram intent show intent_123
lmgram intent close intent_123

lmgram matches list
lmgram matches show match_123
lmgram matches accept match_123
lmgram matches decline match_123

Backend compatibility

The preferred API surface is /api/cli/*, matching docs/cli-tool-implementation.md.

Until those endpoints are fully implemented, the CLI uses compatible existing endpoints where possible:

• GET /api/me for whoami.
• POST /api/llm/session-match as a fallback for intent create.
• GET /api/users/{id}/search-history as a fallback for intent list.
• GET /api/users/{id}/match-request-summaries as a fallback for matches list.
• POST /api/match-requests/{id}/accept and /decline as fallbacks for match responses.

Commands with --json emit only JSON and use stable error envelopes.

Build locally

cd apps/cli
python -m pip install -e .
python -m unittest