@varagenttm/linc-cli

TitleMind.AI L.I.N.C. — Land Intelligence Navigation Center CLI.

Full onboarding and installation manual: See docs/ONBOARDING.md

Quick Install

npm install -g @varagenttm/linc-cli

Install

npm install -g @varagenttm/linc-cli

Two binaries install (identical): linc and varacli.

Quick start

varacli auth login                            # paste your tm_live_... key
varacli setup                                 # one-time wizard: county, format, Google link
varacli                                       # zero args + TTY → interactive TUI
varacli chat "how many wells in la salle"     # one-shot

First-run setup (v0.3.0+)

varacli setup

Four-step wizard:

1. Identity check — fetches /api/auth/whoami and prints your role, key, org, and county allowlist so you can confirm the right account.
2. Default county — saved to ~/.varacli/config.json. Use the county name as it appears in vara-api (e.g. la salle, midland, or comma-list midland,ector for multi-county).
3. Default output format — table (default, terminal-friendly), json (pipe-friendly), or csv (Excel-friendly).
4. Integrations — offers to link Google Workspace for Sheets/Drive/Docs/ Gmail tooling. TexasFile per-user credentials are on the roadmap (0.4.0).

Every step has a sensible default — hit Enter to accept.

Linking Google Workspace

varacli auth google                # link
varacli auth google --unlink       # revoke

auth google starts a local HTTP listener on an ephemeral port, opens your browser to the varagent-gworkspace OAuth flow, and captures the redirect to confirm the link. Same flow as the web auth-gate; works in any terminal with browser access. Takes ~30 seconds.

After linking, the swarm gains access to your Sheets, Drive, Docs, and Gmail — useful for deliverable export (/export writes locally; with Google linked, the swarm can also push runsheets directly into your Drive).

Interactive TUI (v0.2.0+)

Launching varacli with no arguments from a terminal drops you into an interactive chat REPL with the VarAgent multi-agent swarm. Type natural language to chat, or use slash commands for in-session control. Tab completes the highlighted suggestion; up/down arrows recall prior messages from ~/.varacli/input-history.jsonl:

| Command | What it does | |---|---| | /help | show all slash commands | | /county [name] | show or set county context (e.g. /county la salle) | | /session | show current session id + recap | | /session new | start a fresh session | | /session <id> | resume a specific session | | /history | list recent sessions | | /audit | tamper-evident audit trail for current session | | /export [md\|json\|csv] | export current session (default md) | | /save [summary] | snapshot conversation to Permatext long-term memory (ADMIN) | | /restore [topic] | restore a saved Permatext session (ADMIN) | | /tools | list MCP tool categories | | /load <category> | load a tool category | | /autopilot [on\|off\|N] | auto-iterate without approval (default max 10) | | /whoami | show auth identity + scope | | /clear | clear scrollback (session preserved) | | /exit (or /quit) | leave the REPL |

Keyboard shortcuts

| Key | Effect | |---|---| | Enter | submit message | | Ctrl-C | cancel current stream · quit with confirm on empty input | | Ctrl-C (twice in 2s) | hard quit | | Ctrl-D | quit (on empty input) | | Ctrl-L | clear screen |

Opting out of the TUI

VARACLI_NO_TUI=1 varacli   # zero args still prints Commander help

The TUI only triggers when all of these are true:

• zero command-line arguments
• both stdin and stdout are TTYs
• VARACLI_NO_TUI is unset

Anything piped, scripted, or invoked with explicit args runs the existing one-shot Commander mode — unchanged from 0.1.x.

Terminal width

The TUI requires at least 60 columns. Below that it refuses with a hint pointing at one-shot mode.

One-shot commands (unchanged from 0.1.x)

varacli auth login | logout | status
varacli chat "natural language question"
varacli survey list --county midland
varacli wells list --county "la salle" --status active
varacli title chain --party "Lewis Energy"
varacli mineral ownership <tract-id>
varacli monitor list | create | alerts
varacli tools                                # MCP tool categories
varacli tools load <category>
varacli history                              # recent chat sessions
varacli export <session-id>                  # export by id from outside the REPL
varacli audit <session-id>                   # audit trail by id
varacli verify <session-id>                  # tamper-evident verification
varacli engagements ls | show | new | archive | migrate   # per-tenant projects
varacli tracts ls | new | rm                              # parcel defs per engagement
varacli docs ls | tree | get | link | unlink | assign | stats   # tenant doc repo

The engagements / tracts / docs trio is the Phase 24 Tenant Document Repository — an engagement-scoped view over the shared doc cache. Flagship flow: varacli docs tree <county> [abstract] renders the abstract-plant tree (county → abstract → instruments) in ~95ms warm.

See varacli <cmd> --help for full per-command options.

Configuration

Lives in ~/.varacli/:

| File | What's in it | |---|---| | credentials.json | API key (mode 600, owner-only) | | config.json | default county, output format, endpoint overrides | | mcp_session.json | last MCP session id (auto-resumed on next launch) | | input-history.jsonl | last 100 submitted REPL messages, append-only | | sessions/ | /export output target — <session-id>.{md,json,csv} |

Environment overrides

| Variable | Effect | |---|---| | VARA_API_KEY | API key (alternative to credentials.json) | | VARA_API_URL | override vara-api base URL | | VARA_MCP_URL | override vara-mcp SSE endpoint | | VARACLI_NO_TUI | force one-shot mode even with zero args + TTY |

What's new in 0.3.x

• First-run setup wizard (varacli setup) — 4-step interactive onboarding: identity check → default county → default output format → Google Workspace OAuth link
• Google Workspace OAuth (varacli auth google) — local-listener flow that links Sheets / Drive / Docs / Gmail to the swarm in ~30s
• Slash-command inline autocomplete — ghost-text suggestion as you type a slash command; Tab to accept, Enter to submit
• Slash-command dropdown navigation — arrow keys move through the filtered command list when multiple match the prefix
• Up/down arrow input history — recall previously submitted REPL messages from the persistent JSONL log at ~/.varacli/input-history.jsonl
• /save + /restore — snapshot the active TUI conversation into Permatext long-term memory and restore it in a future session (requires ADMIN role)
• /autopilot — let VarAgent iterate without per-turn approval up to a configurable max (default 10); Ctrl+C disables
• Tenant Document Repository (Phase 24) — three new command groups back the engagement-scoped doc view: engagements (per-tenant projects), tracts (parcel definitions per engagement), and docs (the workhorse — ls / tree / get / link / unlink / assign / stats). See outputs/varacli-docs-quickstart.md for the cheat sheet.
• No breaking changes for one-shot users — every existing varacli <cmd> invocation behaves identically to 0.1.x / 0.2.x.

License

UNLICENSED — private to TitleMind AI, LLC.