Lynse CLI Skill

Cross-platform Python CLI (3.8+) for lynse.ai backend services. Works natively on Windows / macOS / Linux.

How to Invoke

Invoke via the Python entrypoint: lynse.py , where is the Python 3

interpreter available in the current environment.

Choosing the interpreter — no single name works everywhere, so pick by environment:

python3 lynse.py me                 # current user info (macOS/Linux)
python3 lynse.py meetings list      # recent meetings

For brevity, the command examples below use python3 as the default — substitute python

(or py -3) on Windows.

• Do NOT use shell scripts (lynse_unified.sh, api_wrapper.sh) — they don't run on Windows.
• In skill contexts, call the Python entrypoint directly. The npm lynse wrapper is for end-user shell usage.

Commands

Friendly Aliases (Preferred)

python3 lynse.py me                                    # Current user info
python3 lynse.py meetings list [--days 7]              # Recent meetings (past N days)
python3 lynse.py meetings month <YYYY-MM>              # Meetings in a specific month
python3 lynse.py meetings week <YYYY-Wnn>              # Meetings in a specific ISO week
python3 lynse.py meetings range <start> <end>          # Meetings in a date range (YYYY-MM-DD)
python3 lynse.py meetings search <keyword>             # Search by title
python3 lynse.py meetings transcript <id>              # Get transcription
python3 lynse.py meetings summary <id>                 # Get AI summary
python3 lynse.py meetings outline <id>                 # Get outline
python3 lynse.py meetings info <id>                    # Meeting details
python3 lynse.py meetings organize [--days N] [--execute] [--yes]   # Auto-classify meetings into folders (dry-run by default; --execute applies)
python3 lynse.py folders list                          # List folders/groups
python3 lynse.py folders create <json>                 # Create folder
python3 lynse.py folders move <json>                   # Move files to folder
python3 lynse.py todos list [all|open|done]            # List todos
python3 lynse.py todos delete <ids>                    # Delete todos
python3 lynse.py todos clear                           # Clear completed todos
python3 lynse.py devices list                          # List bound devices
python3 lynse.py devices info <id>                     # Device details
python3 lynse.py devices unbind <id>                   # Unbind device
python3 lynse.py models list                           # List AI models
python3 lynse.py models add <json>                     # Add model
python3 lynse.py models delete <id>                    # Delete model
python3 lynse.py models edit <json>                    # Edit model
python3 lynse.py models enable <id> <bool>             # Enable/disable model

Date query flexibility (meetings month/week):

python3 lynse.py meetings month 2026-04          # All April 2026 meetings
python3 lynse.py meetings month 4                # April of current year
python3 lynse.py meetings week 2026-W16          # ISO week 16 of 2026
python3 lynse.py meetings range 2026-04-01 2026-04-30   # Custom date range

Auto-organize meetings into folders (meetings organize):

python3 lynse.py meetings organize                       # Dry-run: print a folder plan, change nothing
python3 lynse.py meetings organize --days 90             # Plan only for the last 90 days
python3 lynse.py meetings organize --execute --yes       # Apply: create folders + move meetings (non-interactive)

Classifies meetings (with a summary) into topic folders by title, reusing existing folders where they match and creating new ones (icon + ≤6-char name) otherwise; caps at 10 folders + 🗂其他. Default is a safe dry-run. --execute applies changes; in a non-interactive/agent context it requires --yes (it refuses otherwise). Meetings without a summary are listed but not moved unless --include-no-conclusion is given.

Auth & System

First-time setup: no key is hardcoded — each user inputs their own, saved locally to ~/.lynse/config.json.

python3 lynse.py auth login                    # Interactive prompt for your API key (recommended)
python3 lynse.py auth login --api-key <key> [--host <url>]   # Or pass the key explicitly
python3 lynse.py auth status                                  # Show auth config
python3 lynse.py auth logout [--all]                          # Clear tokens (--all also clears API key)
python3 lynse.py auth doctor                                  # Diagnose auth issues
python3 lynse.py version    # Version, Python, OS, requests info
python3 lynse.py doctor     # Full environment diagnostics
python3 lynse.py update     # Show update instructions

Output Format Control

--json             Compact JSON (default when piped)
--pretty           Pretty-printed JSON (default in terminal)
--text             Human-readable text summary
--table            ASCII table for list results
--output <file>    Save output to file

Combine: python3 lynse.py meetings list --table --output meetings.txt

Output Contract — Meeting Lists

When presenting meeting query results, format as a table using these JSON fields:

Sort by recordStartTime ascending. Append summary line: Total: N meetings, HH:MM.

Exit Codes

Key Constraints

• Base URL: all API requests use $LYNSE_API_HOST. Never hardcode or guess the server address.
• Auth: two-layer API Key + Token. See references/auth-and-security.md for the full flow, config resolution order, and security rules (sensitive data masking, owner-ID guard, token cache permissions).
• Errors: see references/error-handling.md for the HTTP/business error mapping and how to report errors to users.
• Platform paths: the skill installs the same into Claude Code / Cursor / Hermes / OpenClaw. See references/platform-paths.md for per-environment directories and env-var injection.

Reference Docs

• install-guide.md — installation & deployment
• reference.md — scope permissions, CLI version routing, file structure, changelog
• references/auth-and-security.md — auth flow & security rules
• references/error-handling.md — error codes & handling
• references/platform-paths.md — AI assistant environment paths