Get Started

Your agent reads, writes and changes the files in its files folder, as its sandbox file allows. Ask it to keep a list, fix a typo in a note or find where it wrote something, and Link Harness has it on already.

You need the agents plugins, which lnk up agents installs and which bring Link File, and Link Harness. There's nothing to set up, because each start gives the agent its file.

What your agent can do

Your agent sees four tools, each over a path in its files folder, such as work/garden.md.

  • file__read gives a text file, at most 24 KB a call, and says where it stopped so the next call reads on.
  • file__write writes a file whole, making it and its folders.
  • file__replace replaces text it gives exactly, found once, or every time with all.
  • file__find finds files by a part of their name, or the lines holding some text.

Choose what it may write

Your agent writes only the folders its sandbox file's [files] lets it. Link's are instructions/, skills/ and work/, and conversations/ is never written but by its harness.

# ~/.config/lnk/agents/main/sandbox.toml
[files]
write = ["skills", "work"]
read = ["instructions", "conversations"]   # it can't change its own instructions
lnk agent start --sandbox sandbox.toml

Each call runs in a sandbox of its own, made from that file, with no network, so the sandbox holds to [files] whatever the tool is asked. File never follows a link, and reads and writes text files up to 4 MiB.

Reach its team's folder

On a team, your agent's paths reach the team's shared folder at teams/<team>/, as teams/research/drafts/report.md. It reads and writes only the folders of it its sandbox file grants, [files.teams.<team>], which lnk agent team add writes.

lnk agent team add research writer --write drafts --read sources

Troubleshooting

SymptomFix
"you may write only in ..."Add the folder to [files] write.
"you may reach only ... of team ...'s folder"lnk agent team add <team> <agent> with --write or --read that folder.
"is a link, which file doesn't follow"Put the file itself in the files folder.
"isn't text (UTF-8)"File reads and writes text only; run works on other files.
Your agent has no fileIts sandbox is off (--no-sandbox), or its harness isn't Link Harness.

Agents Security has the guarantees and gaps, and Agents Decisions why it works this way. To work on its code, see Developing Link File.