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__readgives a text file, at most 24 KB a call, and says where it stopped so the next call reads on.file__writewrites a file whole, making it and its folders.file__replacereplaces text it gives exactly, found once, or every time withall.file__findfinds 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 instructionslnk agent start --sandbox sandbox.tomlEach 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 sourcesTroubleshooting
| Symptom | Fix |
|---|---|
| "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 file | Its 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.
