Troubleshooting

What to do when your agent doesn't install, start, stay running or answer (Agents). Start by inspecting the current state, then use the symptom below to choose the next check.

lnk agent show

A bad download, often a rate limit. Nothing it downloaded ran, and nothing changed: try again later.

start offers no local models

No model runs on this computer yet: its fix is on the model's troubleshooting.

Linux: "the sandbox needs bubblewrap"

Install it, sudo apt install bubblewrap, then start your agent again in its sandbox.

Ubuntu: bubblewrap can't make the sandbox

Let lnk agent start add the AppArmor profile, which lets bubblewrap make the sandbox.

Linux: the agent stops when you log out

Run sudo loginctl enable-linger $USER, so your services keep running once you log out.

start says a socket is past the bytes a socket's path may be

Link's sockets are under your home, and a home's path over about 48 characters makes them too long: run it as a user with a shorter home.

Linux: start says "no systemd for your user here"

Over SSH, in WSL or a container: run sudo loginctl enable-linger $USER and log in again, or lnk agent start --foreground.

status says it isn't answering

Read lnk agent log show --follow, then the Link Harness page, or its harness's own page.

Getting hallucinations, or it forgets what was said earlier

Its window may be full, and what left it summarized. A larger [window] max in its spec helps, at a higher price per message.