> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentlinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI reference

> CLI commands for authenticated service calls and optional local workflows.

Use the CLI to call authenticated AgentLinkOps operations. The executable is `agentlinkops`; `linktrail` remains a compatibility alias until the DP-0029-T05 cutover. Optional local commands maintain a ledger, inspect public pages and read context. Local commands run from the installed development CLI; installation and hosted access have separate availability requirements.

[Configuration, environment and files](/reference/local/configuration) explains how commands find a ledger. [Local file contracts](/reference/local/artifacts) documents ledger, check and receipt fields. [HTTP conventions](/reference/http/conventions) explains cloud calls.

| Command                                                      | Purpose                                                                                      |
| ------------------------------------------------------------ | -------------------------------------------------------------------------------------------- |
| [`agentlinkops help`](/reference/local/help)                 | Print the command summary.                                                                   |
| [`agentlinkops doctor`](/reference/local/doctor)             | Check the local install and configured cloud connection.                                     |
| [`agentlinkops connect`](/reference/local/connect)           | Verify and save a cloud connection.                                                          |
| [`agentlinkops skill`](/reference/local/skill)               | Read the agent reference or an installed workflow skill, and list the versioned default set. |
| [`agentlinkops tools`](/reference/local/tools)               | List cloud commands by toolset from the bundled catalog snapshot.                            |
| [`agentlinkops describe`](/reference/local/describe)         | Show one cloud command's exact input schema, scopes and run lane.                            |
| [`agentlinkops agent setup`](/reference/local/agent-setup)   | Install the skill pack and the right MCP view for each detected agent client.                |
| [`agentlinkops agent status`](/reference/local/agent-status) | Show which agent clients are configured for AgentLinkOps and what the last setup installed.  |
| [`agentlinkops call`](/reference/local/call)                 | Run a named cloud operation.                                                                 |
| [`agentlinkops migrate`](/reference/local/migrate)           | Rename an existing .linktrail/ directory to .agentlinkops/.                                  |

<Accordion title="Optional local commands">
  | Command                                                                                    | Purpose                                                                                         |
  | ------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------- |
  | [`agentlinkops init`](/reference/local/init)                                               | Create a ledger in the current directory.                                                       |
  | [`agentlinkops add`](/reference/local/add)                                                 | Add a placement intention to the ledger.                                                        |
  | [`agentlinkops import`](/reference/local/import)                                           | Preview a supplier or CSV import.                                                               |
  | [`agentlinkops adopt`](/reference/local/adopt)                                             | Preview conversion of the local SQLite CRM.                                                     |
  | [`agentlinkops adopt-result`](/reference/local/adopt-result)                               | Save a prior single-check result to the ledger.                                                 |
  | [`agentlinkops check`](/reference/local/check)                                             | Check due ledger entries.                                                                       |
  | [`agentlinkops check --source ... --target ...`](/reference/local/check-single)            | Check one supplied page without a ledger.                                                       |
  | [`agentlinkops status`](/reference/local/status)                                           | Compare local intentions with recorded observations.                                            |
  | [`agentlinkops diff`](/reference/local/diff)                                               | Read recorded observation transitions.                                                          |
  | [`agentlinkops fmt`](/reference/local/fmt)                                                 | Format the ledger consistently.                                                                 |
  | [`agentlinkops compact`](/reference/local/compact)                                         | Preview repeated-observation compaction.                                                        |
  | [`agentlinkops report`](/reference/local/report)                                           | Render a local HTML backlink report, or export the same frozen dataset as JSON.                 |
  | [`agentlinkops locate`](/reference/local/locate)                                           | Resolve one observation to its recorded occurrences and evidence reference.                     |
  | [`agentlinkops fleet`](/reference/local/fleet)                                             | Read multiple explicitly named ledgers.                                                         |
  | [`agentlinkops platforms`](/reference/local/platforms)                                     | Summarize observed platform behavior.                                                           |
  | [`agentlinkops mix`](/reference/local/mix)                                                 | Report referring-domain mix from the current ledger.                                            |
  | [`agentlinkops sync`](/reference/local/sync)                                               | Push selected intentions and pull cloud history.                                                |
  | [`agentlinkops citation run`](/reference/local/citation-run)                               | Run one fixed-sample AI-citation epoch over a prompt panel with dated evidence and a spend cap. |
  | [`agentlinkops receive`](/reference/local/receive)                                         | Use a signed event notification to trigger authenticated pull.                                  |
  | [`agentlinkops receipt add`](/reference/local/receipt-add)                                 | Record a local action claim.                                                                    |
  | [`agentlinkops receipt history`](/reference/local/receipt-history)                         | Read claims alongside local verification history.                                               |
  | [`agentlinkops context status`](/reference/local/context-status)                           | Read context connection and file status.                                                        |
  | [`agentlinkops context manual`](/reference/local/context-manual)                           | Read the editable manual context.                                                               |
  | [`agentlinkops context focus`](/reference/local/context-focus)                             | Select focus pages from local context.                                                          |
  | [`agentlinkops context gsc refresh`](/reference/local/context-gsc-refresh)                 | Refresh search context from Google.                                                             |
  | [`agentlinkops context gsc page`](/reference/local/context-gsc-page)                       | Read search context for a supplied page.                                                        |
  | [`agentlinkops context gsc import`](/reference/local/context-gsc-import)                   | Import a GSC connector handoff.                                                                 |
  | [`agentlinkops context gsc forget`](/reference/local/context-gsc-forget)                   | Remove tool-owned context.                                                                      |
  | [`agentlinkops context profile build`](/reference/local/context-profile-build)             | Collect bounded public site facts.                                                              |
  | [`agentlinkops context profile render`](/reference/local/context-profile-render)           | Write an editable site profile from collected facts.                                            |
  | [`agentlinkops context profile check`](/reference/local/context-profile-check)             | Check citations in the local site profile.                                                      |
  | [`agentlinkops context ga4 refresh`](/reference/local/context-ga4-refresh)                 | Refresh optional GA4 context.                                                                   |
  | [`agentlinkops context ga4 page`](/reference/local/context-ga4-page)                       | Read local landing-page business context.                                                       |
  | [`agentlinkops context ga4 key-events`](/reference/local/context-ga4-key-events)           | Read configured GA4 event totals.                                                               |
  | [`agentlinkops context ga4 import`](/reference/local/context-ga4-import)                   | Import a GA4 connector handoff.                                                                 |
  | [`agentlinkops context ga4 forget`](/reference/local/context-ga4-forget)                   | Remove tool-owned GA4 context.                                                                  |
  | [`agentlinkops context business`](/reference/local/context-business)                       | Read search and business context side by side.                                                  |
  | [`agentlinkops context help`](/reference/local/context-help)                               | Print the context subcommand summary.                                                           |
  | [`agentlinkops gsc-links`](/reference/local/gsc-links)                                     | Export a Google Search Console Links report through your signed-in browser.                     |
  | [`agentlinkops citation panel`](/reference/local/citation-panel)                           | Create an editable citation panel.                                                              |
  | [`agentlinkops citation report`](/reference/local/citation-report)                         | Render retained citation evidence as a local HTML report.                                       |
  | [`agentlinkops citation watch`](/reference/local/citation-watch)                           | Schedule local citation measurements and reports.                                               |
  | [`agentlinkops citation alert`](/reference/local/citation-alert)                           | Inspect the latest matching epoch for declines.                                                 |
  | [`agentlinkops citation login`](/reference/local/citation-login)                           | Optionally save a legacy browser session for an engine.                                         |
  | [`agentlinkops citation logout`](/reference/local/citation-logout)                         | Remove a saved local engine session.                                                            |
  | [`agentlinkops citation sessions`](/reference/local/citation-sessions)                     | List locally saved engine sessions.                                                             |
  | [`agentlinkops citation sync`](/reference/local/citation-sync)                             | Copy local epoch summaries to a hosted project.                                                 |
  | [`agentlinkops citation sweep`](/reference/local/citation-sweep)                           | Run a bounded panel epoch and freeze its retained evidence.                                     |
  | [`agentlinkops citation inventory`](/reference/local/citation-inventory)                   | Freeze an existing panel epoch without new engine calls.                                        |
  | [`agentlinkops citation gap`](/reference/local/citation-gap)                               | Compare citations and mentions within a frozen dataset.                                         |
  | [`agentlinkops citation export-sources`](/reference/local/citation-export-sources)         | Export cited surfaces as held opportunity-library candidates.                                   |
  | [`agentlinkops index`](/reference/local/index-receipts)                                    | Keep dated index evidence in this repository.                                                   |
  | [`agentlinkops index pull`](/reference/local/index-pull)                                   | Download a page of index receipts.                                                              |
  | [`agentlinkops index import`](/reference/local/index-import)                               | Import exported index receipts.                                                                 |
  | [`agentlinkops index export`](/reference/local/index-export)                               | Export the local index receipt archive.                                                         |
  | [`agentlinkops index csv`](/reference/local/index-csv)                                     | Join URLs to retained index observations.                                                       |
  | [`agentlinkops index check-csv`](/reference/local/index-check-csv)                         | Inspect selected monitored URLs and write a CSV receipt.                                        |
  | [`agentlinkops index submissions-import`](/reference/local/index-submissions-import)       | Retain reported IndexNow responses as immutable local receipts.                                 |
  | [`agentlinkops index submissions-export`](/reference/local/index-submissions-export)       | Export one project’s local submission receipts.                                                 |
  | [`agentlinkops index reconcile-submissions`](/reference/local/index-reconcile-submissions) | Compare submission attempts with later retained index observations.                             |
  | [`agentlinkops lifecycle`](/reference/local/lifecycle)                                     | Read and update placement deal metadata, retain due renewal notices or report cost by currency. |
  | [`agentlinkops admission`](/reference/local/admission)                                     | Manage project admission rules or inspect current and retained decisions.                       |
  | [`agentlinkops disavow`](/reference/local/disavow)                                         | Propose project disavow rules and export retained active rules.                                 |
  | [`agentlinkops agent remove`](/reference/local/agent-remove)                               | Remove unchanged installer-owned skills and MCP entries while preserving customer records.      |
  | [`agentlinkops agent recover`](/reference/local/agent-recover)                             | Recover an interrupted installer transaction from its recorded backups.                         |
</Accordion>
