Agent Commands

Every command the agent module offers, from its declarations, in order of the resource each acts on. Each command's help says the same.

Agent

lnk agent connect

Connect your agent to Telegram, Slack, Discord or Signal

lnk agent connect <connection> [--agent <agent>]

It takes --agent, -a, string: The agent [default: the only one here]. It takes connection, position 1, string, required: A connection: telegram reads the bot's token from LNK_TELEGRAM_TOKEN, slack its two tokens from LNK_SLACK_BOT_TOKEN and LNK_SLACK_APP_TOKEN, discord its bot's token from LNK_DISCORD_TOKEN, signal the agent's number and your own (lnk agent connect signal asks), or another connection module's. It answers core.report.

lnk agent create

Make another agent, and start it (--agent then picks it)

lnk agent create <name> [place] [--cloud <cloud>] [--foreground] [--here] [--let-sleep] [--no-sandbox] [--on <on>] [--sandbox <sandbox>] [--spec <spec>] [--yes] [--zone <zone>] [field flags]
  • --cloud, string: A cloud account
  • --foreground, boolean: Run it in this terminal instead of in the background
  • --here, boolean: This machine
  • --let-sleep, boolean: Let the machine sleep while it runs, this start alone: the next start keeps it awake again unless its spec's [run] let_sleep says otherwise
  • name, position 1, string, required: Its name: lowercase letters, digits and dashes, starting with a letter; not here or all, which are Link's words
  • --no-sandbox, boolean: Run with no sandbox, from now on, until a start with --sandbox: the harness can then read your whole home folder (documents, SSH keys, browser data) and write outside its own. The only way to run without one, never implied by --yes. Available on a computer or box; refused where trusted machine policy forbids it (unsandboxed = false in agents.toml) or policy cannot be trusted
  • --on, string: A machine
  • place, position 2, string: A machine, a cloud account, or here: short for --on , --cloud or --here
  • --sandbox, path: A sandbox file, a TOML file of what you grant the agent whichever harness runs it (lnk agent show --permissions shows it): kept with its settings, in place of what lnk agent permission add and remove wrote. It runs in its sandbox from now on; given alone, as --sandbox own, it only runs in its own sandbox again, after --no-sandbox
  • --spec, path: A spec file, a TOML file of its opinions over Link's, its field flags laid over it (lnk agent spec show prints the whole): kept with its settings, read at every start
  • --yes, boolean: Say yes to what it would ask
  • --zone, string: A region or zone of the cloud

It reads the agent spec, from a file or its field flags. It answers core.report.

lnk agent delete

Delete an agent here for good: its settings, harnesses and service, and its files after asking

lnk agent delete <name> [--delete-files] [--yes]
  • --delete-files, boolean: Delete its files folder too, when it's its own
  • name, position 1, string, required: An agent (lnk agent list)
  • --yes, boolean: Say yes to what it would ask

It answers core.report.

lnk agent disconnect

Disconnect your agent from a connection

lnk agent disconnect <connection> [--agent <agent>]

It takes --agent, -a, string: The agent [default: the only one here]. It takes connection, position 1, string, required: A connection: telegram, slack, discord, signal, or another connection module's. It answers core.report.

lnk agent list

List every agent, here and on each of your boxes

lnk agent list [--here] [--json] [--refresh]
  • --here, boolean: Only this machine's agents, without asking your boxes
  • --json, boolean: Print the answer as JSON for other programs
  • --refresh, boolean: Ask your clouds for boxes made on your other computers too, not only those this one knows

It answers agent.life-agents.

lnk agent migrate

Bring an agent you already have under Link, keeping its harness: OpenClaw, Hermes or DeepSeek, installed here outside Link

lnk agent migrate [--agent <agent>] [--clean] [--harness <harness>] [--yes]
  • --agent, -a, string: The agent [default: the only one here]
  • --clean, boolean: Once your agent answers under Link: remove the original install, every file of it named first
  • --harness, string: The harness to bring in, when more than one is installed: openclaw, hermes or deepseek
  • --yes, boolean: Say yes to what it would ask

It answers core.report.

lnk agent move

Move an agent to one of your boxes, a cloud, or back here

lnk agent move [place] [--agent <agent>] [--cloud <cloud>] [--here] [--image <image>] [--on <on>] [--yes] [--zone <zone>]
  • --agent, -a, string: The agent [default: the only one here]
  • --cloud, string: A cloud account
  • --here, boolean: This machine
  • --image, string: A new box in the cloud account TO, from one of your images there (lnk box image list): the agent moves onto a box already set up
  • --on, string: A machine
  • place, position 1, string: A machine, a cloud account, or here: short for --on , --cloud or --here
  • --yes, boolean: Say yes to what it would ask
  • --zone, string: A region or zone of the cloud

It answers core.report.

lnk agent restart

Stop your existing agent, then start it in the background with its saved settings

lnk agent restart [--agent <agent>]

It takes --agent, -a, string: The agent [default: the only one here]. It answers core.report.

lnk agent show

Show everything about this agent

lnk agent show [name] [--agent <agent>] [--harness <harness>] [--instructions] [--json] [--permissions]
  • --agent, -a, string: The agent [default: the only one here]
  • --harness, string: A harness (lnk agent harness list) whose needs --permissions shows [default: your agent's]
  • --instructions, boolean: Show the prompt your agent's model gets, exactly as its harness sends it
  • --json, boolean: Print the answer as JSON for other programs
  • name, position 1, string: An agent (lnk agent list): what lnk agent show shows of it, as typed blocks with --json
  • --permissions, boolean: Show what your agent may do beyond its harness's home, here

It answers agent.life-agent-entry.

lnk agent start

Start your agent (Link Harness by default), in the background

lnk agent start [--agent <agent>] [--foreground] [--let-sleep] [--no-sandbox] [--sandbox <sandbox>] [--spec <spec>] [--yes] [field flags]
  • --agent, -a, string: The agent [default: the only one here]
  • --foreground, boolean: Run it in this terminal instead of in the background
  • --let-sleep, boolean: Let the machine sleep while it runs, this start alone: the next start keeps it awake again unless its spec's [run] let_sleep says otherwise
  • --no-sandbox, boolean: Run with no sandbox, from now on, until a start with --sandbox: the harness can then read your whole home folder (documents, SSH keys, browser data) and write outside its own. The only way to run without one, never implied by --yes. Available on a computer or box; refused where trusted machine policy forbids it (unsandboxed = false in agents.toml) or policy cannot be trusted
  • --sandbox, path: A sandbox file, a TOML file of what you grant the agent whichever harness runs it (lnk agent show --permissions shows it): kept with its settings, in place of what lnk agent permission add and remove wrote. It runs in its sandbox from now on; given alone, as --sandbox own, it only runs in its own sandbox again, after --no-sandbox
  • --spec, path: A spec file, a TOML file of its opinions over Link's, its field flags laid over it (lnk agent spec show prints the whole): kept with its settings, read at every start
  • --yes, boolean: Say yes to what it would ask

It reads the agent spec, from a file or its field flags. It answers core.report.

lnk agent stop

Stop your agent

lnk agent stop [--agent <agent>]

It takes --agent, -a, string: The agent [default: the only one here]. It answers core.report.

Browser

lnk agent browser click

Click an element of the open page

lnk agent browser click [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

lnk agent browser close

Close the page open in the agent's browser

lnk agent browser close [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

lnk agent browser open

Open a page in the agent's browser

lnk agent browser open [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

lnk agent browser read

Read the page open in the agent's browser

lnk agent browser read [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

lnk agent browser screenshot

Take a screenshot of the open page

lnk agent browser screenshot [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

lnk agent browser scroll

Scroll the open page

lnk agent browser scroll [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

lnk agent browser select

Choose an option of a menu on the open page

lnk agent browser select [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

lnk agent browser type

Type into an element of the open page

lnk agent browser type [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

Chat

lnk agent chat compact

Compact the current conversation

lnk agent chat compact [--agent <agent>] [--chat <chat>] [--json]
  • --agent, -a, string: The agent [default: the only one here]
  • --chat, string: The chat to act on
  • --json, boolean: Print the answer as JSON for other programs

It answers agent.chat-turn.

lnk agent chat export

Export the current conversation

lnk agent chat export [--agent <agent>] [--chat <chat>] [--format <format>] [--json]
  • --agent, -a, string: The agent [default: the only one here]
  • --chat, string: The chat to act on
  • --format, string: Rewrite every conversation in this format, as [storage] conversations names one
  • --json, boolean: Print the answer as JSON for other programs

It answers agent.chat-turn.

lnk agent chat fork

Copy the chat before an owner's message into a fresh Link chat, preserving the original

lnk agent chat fork <chat> [--agent <agent>] --before <before>
  • --agent, -a, string: The agent [default: the only one here]
  • --before, integer, required: The sequence number of the owner's message to edit; the copy ends before it
  • chat, position 1, string, required: A chat (lnk agent chat list), such as link:main

It answers agent.chat.

lnk agent chat get

Get one value of the current conversation: its goal

lnk agent chat get <field> [--agent <agent>] [--chat <chat>] [--json]
  • --agent, -a, string: The agent [default: the only one here]
  • --chat, string: The chat to act on
  • field, position 1, one of goal, required: The value to get: goal, the condition the chat works toward
  • --json, boolean: Print the answer as JSON for other programs

It answers agent.chat-turn.

lnk agent chat list

List this agent's Link conversations, when its harness supports typed history

lnk agent chat list [--agent <agent>] [--json]

It takes --agent, -a, string: The agent [default: the only one here]. It takes --json, boolean: Print the answer as JSON for other programs. It answers agent.chat-list.

lnk agent chat send

Send one message to your agent on Link's own connection

lnk agent chat send [--action <action>] [--agent <agent>] [--aside] [--chat <chat>] [--cloud <cloud>] [--connection <connection>] [--json] [--member <member>] [--message <message>] [--queue] [--steer] [--stream-json] [--team <team>] [--to <to>]
  • --action, string: Run one agent action, such as model
    , then exit
  • --agent, -a, string: The agent [default: the only one here]
  • --aside, boolean: Ask it as a side question, answered apart and kept out of the conversation
  • --chat, string: A chat (lnk agent chat list), such as link:<name> [default: main; with --team, one for that team; with --to, the owner's chat to reply in, or the chat for a teammate's reply]
  • --cloud, string: A cloud account, as lnk cloud list names it
  • --connection, string: With --to owner: where to message the owner, a connected service, or cli for this computer's lnk agent chat
  • --json, boolean: Print the answer as JSON for other programs
  • --member, string: With --team: a unique member name within the team [default: its selected lead]
  • --message, -m, string: Send this one message, print the answer and exit. On the command line, other processes here can read it; on stdin they can't
  • --queue, boolean: Send it after the answer being written
  • --steer, boolean: Let it join the answer being written
  • --stream-json, boolean: Stream NDJSON text records for a remote client
  • --team, string: Message this team through its lead (lnk agent team list), or team@account for hosting
  • --to, string: Send as the agent: owner, or a teammate as teammate:<name or ID>

It answers agent.chat-turn.

lnk agent chat set

Set one value of the current conversation: its goal, its name, or whether it shows each tool call

lnk agent chat set <field> [value] [--agent <agent>] [--chat <chat>] [--clear] [--json]
  • --agent, -a, string: The agent [default: the only one here]
  • --chat, string: The chat to act on
  • --clear, boolean: Clear the goal instead of setting it
  • field, position 1, one of goal, name, verbose, required: The value to set: goal, a condition the chat works toward, name, the conversation's name, or verbose, whether it shows each tool call
  • --json, boolean: Print the answer as JSON for other programs
  • value, position 2, string: Its new value: a goal, a name, or on or off

It answers agent.chat-turn.

lnk agent chat show

Print one of your agent's chats as you'd read it, wherever it's kept

lnk agent chat show <chat> [--agent <agent>] [--json] [--status]
  • --agent, -a, string: The agent [default: the only one here]
  • chat, position 1, string, required: A chat (lnk agent chat list), such as link:main or telegram:123456789
  • --json, boolean: Print the answer as JSON for other programs
  • --status, boolean: Show the chat's current conversation's model and usage, as its running harness says, instead of what was said

It answers agent.chat.

lnk agent chat start

Start a fresh live conversation with your agent; --chat selects an existing named chat

lnk agent chat start [--agent <agent>] [--chat <chat>] [--json] [--message <message>]
  • --agent, -a, string: The agent [default: the only one here]
  • --chat, string: Continue this named chat instead of opening a fresh one
  • --json, boolean: Print the answer as JSON for other programs
  • --message, -m, string: Open the chat with this first message, then keep talking

It answers core.report.

lnk agent chat stop

Stop the current answer

lnk agent chat stop [--agent <agent>] [--chat <chat>] [--json]
  • --agent, -a, string: The agent [default: the only one here]
  • --chat, string: The chat to act on
  • --json, boolean: Print the answer as JSON for other programs

It answers agent.chat-turn.

Cron

lnk agent cron create

Schedule a prompt for the agent by a cron, recurring or once

lnk agent cron create [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers scheduler-tool.scheduled.

lnk agent cron delete

Delete a schedule

lnk agent cron delete [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

lnk agent cron list

List the agent's schedules

lnk agent cron list [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

Desktop

lnk agent desktop click

Click a point of the desktop

lnk agent desktop click [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

lnk agent desktop drag

Drag from one point of the desktop to another

lnk agent desktop drag [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

lnk agent desktop key

Press a key or a combination on the desktop

lnk agent desktop key [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

lnk agent desktop screenshot

Take a screenshot of the desktop

lnk agent desktop screenshot [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

lnk agent desktop scroll

Scroll the desktop

lnk agent desktop scroll [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

lnk agent desktop type

Type text on the desktop

lnk agent desktop type [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

File

lnk agent file definition

Find where a symbol is defined

lnk agent file definition [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

lnk agent file diagnostics

List a file's errors and warnings

lnk agent file diagnostics [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

lnk agent file edit

Replace text in a file

lnk agent file edit [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

lnk agent file glob

Find files in the agent's files by a glob

lnk agent file glob [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

lnk agent file grep

Find lines in the agent's files by a regular expression

lnk agent file grep [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

lnk agent file read

Read a file

lnk agent file read [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

lnk agent file references

Find where a symbol is used

lnk agent file references [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

lnk agent file write

Write a file

lnk agent file write [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

Harness Permission

lnk agent harness-permission add

Allow something the harness asks for: a spec's flags, or a risk of its own

lnk agent harness-permission add [risk] [--agent <agent>] [--harness <harness>] [--spec <file>] [field flags]
  • --agent, -a, string: The agent [default: the only one here]
  • --harness, string: The harness [default: the agent's]
  • risk, position 1, string: A risk the harness named itself

It reads the sandbox spec, from a file or its field flags. It answers core.report.

lnk agent harness-permission list

Show what the harness said it needs here and you allowed (add / remove)

lnk agent harness-permission list [--agent <agent>] [--harness <harness>]

It takes --agent, -a, string: The agent [default: the only one here]. It takes --harness, string: The harness [default: the agent's]. It answers core.report.

lnk agent harness-permission remove

Take back something the harness needs: a spec's flags, or a risk of its own

lnk agent harness-permission remove [risk] [--agent <agent>] [--harness <harness>] [--spec <file>] [field flags]
  • --agent, -a, string: The agent [default: the only one here]
  • --harness, string: The harness [default: the agent's]
  • risk, position 1, string: A risk the harness named itself

It reads the sandbox spec, from a file or its field flags. It answers core.report.

Harness

lnk agent harness check

Test its sandbox: try what it shouldn't be able to do

lnk agent harness check [--agent <agent>] [--harness <harness>]

It takes --agent, -a, string: The agent [default: the only one here]. It takes --harness, string: The harness [default: the agent's]. It answers core.report.

lnk agent harness delete

Delete a harness completely: its home, any traces, and its grants

lnk agent harness delete [--agent <agent>] [--harness <harness>] [--yes]
  • --agent, -a, string: The agent [default: the only one here]
  • --harness, string: The harness [default: the agent's]
  • --yes, boolean: Say yes to what it would ask

It answers core.report.

lnk agent harness list

List the harnesses, and which this agent runs

lnk agent harness list [--agent <agent>] [--harness <harness>]

It takes --agent, -a, string: The agent [default: the only one here]. It takes --harness, string: The harness [default: the agent's]. It answers core.report.

lnk agent harness reset

Forget what you answered the harness, so its next start asks again

lnk agent harness reset [--agent <agent>] [--harness <harness>]

It takes --agent, -a, string: The agent [default: the only one here]. It takes --harness, string: The harness [default: the agent's]. It answers core.report.

lnk agent harness run

Run a command in its sandbox, as it runs for your agent

lnk agent harness run [--agent <agent>] [-- <command>...] [--harness <harness>]
  • --agent, -a, string: The agent [default: the only one here]
  • command, after --, list of string, required: The command, after --
  • --harness, string: The harness [default: the agent's]

It answers core.report.

lnk agent harness set

Set your agent's harness: one of Link's, or one from outside Link

lnk agent harness set <harness> [--agent <agent>] [--foreground] [--yes]
  • --agent, -a, string: The agent [default: the only one here]
  • --foreground, boolean: Run it in this terminal instead of in the background
  • harness, position 1, string, required: The harness to set (lnk agent harness list)
  • --yes, boolean: Say yes to what it would ask

It answers core.report.

lnk agent harness show

Show where it lives for your agent, and anything of it outside its home

lnk agent harness show [--agent <agent>] [--harness <harness>]

It takes --agent, -a, string: The agent [default: the only one here]. It takes --harness, string: The harness [default: the agent's]. It answers core.report.

Log

lnk agent log show

Show your agent's log, or watch what it does as it does it

lnk agent log show [--agent <agent>] [--follow] [--json] [--live]
  • --agent, -a, string: The agent [default: the only one here]
  • --follow, -f, boolean: Keep printing new lines
  • --json, boolean: Print the answer as JSON for other programs
  • --live, boolean: Print what your agent does as it does it, until Ctrl-C

It answers agent.life-log-line.

Memory

lnk agent memory show

Show which engine serves your agent's memory, over which folder, and where it reaches it

lnk agent memory show [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers memory.remembered.

lnk agent memory start

Serve a memory engine over your agent's files: link (the default)

lnk agent memory start [engine] [--agent <agent>]

It takes --agent, -a, string: The agent [default: the only one here]. It takes engine, position 1, string: The engine [default: link]. It answers core.report.

lnk agent memory stop

Stop serving your agent's memory (its files stay)

lnk agent memory stop [--agent <agent>]

It takes --agent, -a, string: The agent [default: the only one here]. It answers core.report.

Model

lnk agent model chat

Ask the model a question

lnk agent model chat [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers model.stream.

lnk agent model context

Show what the agent's context is spent on

lnk agent model context [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers model.context.

lnk agent model count

Count the tokens of a text

lnk agent model count [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers model.counted.

lnk agent model embed

Embed texts with the model

lnk agent model embed [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers model.embedded.

lnk agent model list

List the models the agent may use

lnk agent model list [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers model.names.

lnk agent model set

Set the agent's persistent model, or one conversation's model

lnk agent model set <model> [--agent <agent>] [--chat <chat>] [--json]
  • --agent, -a, string: The agent [default: the only one here]
  • --chat, string: The chat to act on
  • --json, boolean: Print the answer as JSON for other programs
  • model, position 1, string, required: The model to set, its name saying who serves it: local/qwen3:8b, anthropic/claude-sonnet-5-5, openai/gpt-6.1-sol or openrouter/deepseek/deepseek-v4

It answers core.report.

lnk agent model show

Show the model the agent uses

lnk agent model show [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers model.shown.

lnk agent model status

Show whether the model is ready

lnk agent model status [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers model.status.

lnk agent model transcribe

Transcribe audio with the model

lnk agent model transcribe [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers model.heard.

lnk agent model usage

Show the agent's measured model usage

lnk agent model usage [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers model.usage.

Permission

lnk agent permission add

Let your agent do more, whichever harness runs it: a spec's flags

lnk agent permission add [--agent <agent>] [--spec <file>] [field flags]

It takes --agent, -a, string: The agent [default: the only one here]. It reads the sandbox spec, from a file or its field flags. It answers core.report.

lnk agent permission remove

Take a grant of your agent's away again: a spec's flags

lnk agent permission remove [--agent <agent>] [--spec <file>] [field flags]

It takes --agent, -a, string: The agent [default: the only one here]. It reads the sandbox spec, from a file or its field flags. It answers core.report.

Question

lnk agent question list

Review owner questions, edit a draft or submit an exact response

lnk agent question list [code] [--agent <agent>] [--draft <draft>] [--json] [--reply <reply>] [--submit <submit>]
  • --agent, -a, string: The agent [default: the only one here]
  • code, position 1, string: The question's response code
  • --draft, path: Save a complete draft from a JSON set submission without sending it
  • --json, boolean: Print the answer as JSON for other programs
  • --reply, string: Submit this targeted text response
  • --submit, integer: Submit exactly this saved draft revision

It answers agent.life-question-delivery.

Share

lnk agent share add

Share a chat with your agent: a Slack connection, a Telegram group, a Discord connection

lnk agent share add <connection> [--agent <agent>] [--json]
  • --agent, -a, string: The agent [default: the only one here]
  • connection, position 1, string, required: A connection the chat is on: slack, telegram or discord
  • --json, boolean: Print the answer as JSON for other programs

It answers agent.share.

lnk agent share list

List the chats your agent is shared with

lnk agent share list [--agent <agent>] [--json]

It takes --agent, -a, string: The agent [default: the only one here]. It takes --json, boolean: Print the answer as JSON for other programs. It answers list of agent.share.

lnk agent share remove

Stop sharing a chat with your agent

lnk agent share remove <chat> [--agent <agent>] --connection <connection> [--json]
  • --agent, -a, string: The agent [default: the only one here]
  • chat, position 1, string, required: A chat, by its id or its name, as lnk agent share list lists it
  • --connection, string, required: A connection the chat is on
  • --json, boolean: Print the answer as JSON for other programs

It answers agent.share.

Skill

lnk agent skill add

Copy a skill into your agent's skills/, named as its SKILL.md says

lnk agent skill add [path] [--agent <agent>] [--replace] [--url <url>]
  • --agent, -a, string: The agent [default: the only one here]
  • path, position 1, string: A folder or a SKILL.md on this machine
  • --replace, boolean: Replace a skill of the same name your agent has
  • --url, string: A git URL, a file:// URL or a GitHub folder page

It answers core.report.

lnk agent skill list

List your agent's skills: each one's name and what it's for

lnk agent skill list [--agent <agent>]

It takes --agent, -a, string: The agent [default: the only one here]. It answers core.report.

lnk agent skill remove

Remove a skill from your agent's skills/, by its name

lnk agent skill remove <name> [--agent <agent>]

It takes --agent, -a, string: The agent [default: the only one here]. It takes name, position 1, string, required: A skill (lnk agent skill list). It answers core.report.

State

lnk agent state export

Export portable state, including retained conversation evidence where supported

lnk agent state export [--agent <agent>] [--json]

It takes --agent, -a, string: The agent [default: the only one here]. It takes --json, boolean: Print the answer as JSON for other programs. It answers agent.state.

Task

lnk agent task agent

Give a task to an agent

lnk agent task agent [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

lnk agent task list

List the agent's tasks

lnk agent task list [--agent <agent>] [--all] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --all, boolean: Every conversation's scheduled work and subagents, yours to see from this machine's command line, not only one conversation's
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

lnk agent task read

Read a task's output

lnk agent task read [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

lnk agent task run

Run a shell command, waiting for it or in the background

lnk agent task run [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

lnk agent task stop

Stop a task

lnk agent task stop [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers core.mcp.

Team Member

lnk agent team-member add

Add another account's hosted agent to a hosted team; its owner must join

lnk agent team-member add <team> [--as <as>] [--cloud <cloud>] --member <member> [--purpose <purpose>] [--read <read>] [--write <write>]
  • --as, string: Its name in the team (its ID, else)
  • --cloud, string: A cloud account, as lnk cloud list names it
  • --member, string, required: The invited agent's account owner and permanent ID, owner/id
  • --purpose, string: What it's for on the team, a line its teammates are told
  • --read, list of string: A shared folder it only reads (repeatable; . for all)
  • team, position 1, string, required: A hosted team (lnk agent team list)
  • --write, list of string: A shared folder it writes (repeatable; . for all, the default)

It answers core.report.

Team Memory

lnk agent team-memory start

Turn a team's memory on: one memory over its shared folder, handed to each member granted all of it (--read . or --write .)

lnk agent team-memory start <team>

It takes team, position 1, string, required: A team with a shared folder (lnk agent team list). It answers core.report.

lnk agent team-memory stop

Turn a team's memory off (its folder and what it kept stay)

lnk agent team-memory stop <team>

It takes team, position 1, string, required: A team (lnk agent team list). It answers core.report.

Team

lnk agent team add

Add an agent to a team, or change its purpose or folders there

lnk agent team add <team> [--as <as>] --member <member> [--purpose <purpose>] [--read <read>] [--write <write>]
  • --as, string: Its name in the team (its own, else)
  • --member, string, required: An agent (lnk agent list)
  • --purpose, string: What it's for on the team, a line its teammates are told
  • --read, list of string: A folder of the shared folder it only reads (repeatable; . for all of it)
  • team, position 1, string, required: A team (lnk agent team list)
  • --write, list of string: A folder of the shared folder it writes (repeatable; . for all of it)

It answers core.report.

lnk agent team backup

Back up a hosted team's shared folder

lnk agent team backup <team> [--agent <agent>] [--cloud <cloud>]
  • --agent, -a, string: The agent [default: the only one here]
  • --cloud, string: A cloud account, as lnk cloud list names it
  • team, position 1, string, required: A hosted team (lnk agent team list)

It answers core.report.

lnk agent team create

Make a team, with these agents on it, or as its spec says

lnk agent team create [team] [--cloud <cloud>] [--no-folder] [--read <read>] [--spec <spec>] [--with <with>] [--write <write>] [field flags]
  • --cloud, string: A cloud account, as lnk cloud list names it
  • --no-folder, boolean: No shared folder, and so no memory of the team's
  • --read, list of string: A folder of the shared folder each member named only reads (repeatable; . for all of it)
  • --spec, path: The team spec file to make the team from or apply again
  • team, position 1, string: Its name [default: the spec's]
  • --with, list of string: An agent (lnk agent list) to put on the team (repeatable); --lead names the one that receives messages addressed to the team
  • --write, list of string: A folder of the shared folder each member named writes (repeatable; . for all of it)

It reads the team spec, from a file or its field flags. It answers core.report.

lnk agent team delete

Delete a team: its members leave it, and its folder stays

lnk agent team delete <team> [--agent <agent>] [--cloud <cloud>] [--yes]
  • --agent, -a, string: The agent [default: the only one here]
  • --cloud, string: A cloud account, as lnk cloud list names it
  • team, position 1, string, required: A team (lnk agent team list)
  • --yes, boolean: Say yes to what it would ask

It answers core.report.

lnk agent team join

Accept a hosted agent's invitation to another account's team

lnk agent team join <team> [--account <account>] [--cloud <cloud>] --member <member>
  • --account, string: A Link account, by its username or ID
  • --cloud, string: A cloud account, as lnk cloud list names it
  • --member, string, required: Your hosted agent's name or permanent ID
  • team, position 1, string, required: The team (lnk agent team list)

It answers core.report.

lnk agent team leave

End your hosted agent's membership in another account's team

lnk agent team leave <team> [--account <account>] [--cloud <cloud>] --member <member>
  • --account, string: A Link account, by its username or ID
  • --cloud, string: A cloud account, as lnk cloud list names it
  • --member, string, required: Your hosted agent's name or permanent ID
  • team, position 1, string, required: The team (lnk agent team list)

It answers core.report.

lnk agent team list

List the teams, each member's purpose and what it reaches

lnk agent team list [--agent <agent>] [--json]

It takes --agent, -a, string: The agent [default: the only one here]. It takes --json, boolean: Print the answer as JSON for other programs. It answers agent.teams-listed.

lnk agent team move

Move a team with all its own members and its shared folder

lnk agent team move <team> [place] [--agent <agent>] [--cloud <cloud>] [--here] [--on <on>] [--yes] [--zone <zone>]
  • --agent, -a, string: The agent [default: the only one here]
  • --cloud, string: A cloud account
  • --here, boolean: This machine
  • --on, string: A machine
  • place, position 2, string: A machine, a cloud account, or here: short for --on , --cloud or --here
  • team, position 1, string, required: A team (lnk agent team list), as team@cloud when a cloud hosts it
  • --yes, boolean: Say yes to what it would ask
  • --zone, string: A region or zone of the cloud

It answers core.report.

lnk agent team remove

Remove an agent from a team

lnk agent team remove <team> [--cloud <cloud>] --member <member>
  • --cloud, string: A cloud account, as lnk cloud list names it
  • --member, string, required: An agent (lnk agent list)
  • team, position 1, string, required: A team (lnk agent team list)

It answers core.report.

lnk agent team restore

Restore a hosted team's shared folder from its backup

lnk agent team restore <team> [--agent <agent>] [--cloud <cloud>]
  • --agent, -a, string: The agent [default: the only one here]
  • --cloud, string: A cloud account, as lnk cloud list names it
  • team, position 1, string, required: A hosted team (lnk agent team list)

It answers core.report.

lnk agent team show

Show a team, or with --member one of its members: its agent, purpose, state and what it reaches here, or accepted membership on a hosting cloud

lnk agent team show <team> [--agent <agent>] [--cloud <cloud>] [--json] [--member <member>]
  • --agent, -a, string: The agent [default: the only one here]
  • --cloud, string: A cloud account, as lnk cloud list names it
  • --json, boolean: Print the answer as JSON for other programs
  • --member, string: One member of the team
  • team, position 1, string, required: A team (lnk agent team list)

It answers agent.teams-hosted-shown.

lnk agent team start

Start the team's members, keeping their permanent identities

lnk agent team start <team> [--agent <agent>] [--cloud <cloud>]
  • --agent, -a, string: The agent [default: the only one here]
  • --cloud, string: A cloud account, as lnk cloud list names it
  • team, position 1, string, required: Team whose members to start

It answers core.report.

lnk agent team stop

Stop the team's members, preserving agents, identities and files

lnk agent team stop <team> [--agent <agent>] [--cloud <cloud>]
  • --agent, -a, string: The agent [default: the only one here]
  • --cloud, string: A cloud account, as lnk cloud list names it
  • team, position 1, string, required: Team whose members to stop

It answers core.report.

Tool

lnk agent tool add

Give your agent a tool: memory, web, browser, desktop, scheduler, run, file, code or your own

lnk agent tool add <tool> [--agent <agent>] [--yes]
  • --agent, -a, string: The agent [default: the only one here]
  • tool, position 1, string, required: The tool: memory (search over its files and conversations, and notes), web (pages, and a search with a Brave Search or Tavily key, from BRAVE_API_KEY or TAVILY_API_KEY, or asked for), browser, desktop, scheduler, run, file, code, or another tool's name
  • --yes, boolean: Say yes to what it would ask

It answers core.report.

lnk agent tool list

List the tools your agent has

lnk agent tool list [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers agent.tool-namespaces.

lnk agent tool remove

Take a tool from your agent (what it kept stays)

lnk agent tool remove <tool> [--agent <agent>]

It takes --agent, -a, string: The agent [default: the only one here]. It takes tool, position 1, string, required: The tool: memory, web, or another tool's name. It answers core.report.

Web

lnk agent web fetch

Fetch a web page

lnk agent web fetch [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers web-tool.page.

Search the web

lnk agent web search [--agent <agent>] [--json] [--request <request>]
  • --agent, -a, string: The agent [default: the only one here]
  • --json, boolean: Print the answer as JSON for other programs
  • --request, string: JSON request file (default: standard input)

It answers web-tool.results.

Webhook

lnk agent webhook create

Create a webhook, and print its address and its secret, once

lnk agent webhook create <name> [--agent <agent>] [--questions-per-day <questions-per-day>] [--sender <sender>]
  • --agent, -a, string: The agent [default: the only one here]
  • name, position 1, string, required: Its name: what your agent sees it's from (webhook:)
  • --questions-per-day, integer: How many questions ({"question": "..."}) it may ask you on your chats a day [default: 20]
  • --sender, one of link, github: The scheme that signs the posts: link or github

It answers agent.webhook-secret.

lnk agent webhook delete

Delete a webhook: its address takes no more posts, and its secrets are forgotten

lnk agent webhook delete <name> [--agent <agent>]

It takes --agent, -a, string: The agent [default: the only one here]. It takes name, position 1, string, required: The webhook. It answers core.report.

lnk agent webhook list

List the agent's webhooks: each name, who signs it and its address, never its secret

lnk agent webhook list [--agent <agent>] [--json]

It takes --agent, -a, string: The agent [default: the only one here]. It takes --json, boolean: Print the answer as JSON for other programs. It answers agent.webhook.

lnk agent webhook rotate

Give a webhook a new secret, printed once

lnk agent webhook rotate <name> [--agent <agent>] [--done]
  • --agent, -a, string: The agent [default: the only one here]
  • --done, boolean: Its sender has the new secret: stop taking the previous one now, and make none
  • name, position 1, string, required: The webhook

It answers agent.webhook-secret.