Troubleshooting

What to do when your agent's model doesn't start, answer or remember (Switch Models). Start by inspecting the current state, then use the symptom below to choose the next check.

lnk agent show

start offers no local models

Run lnk up, then lnk model install, or start your runtime, so a model runs on this computer for start to offer.

"several model runtimes are running"

Name the model with --model.default, so Link knows which runtime to start your agent on.

One Model on Several Runtimes

When several runtimes serve that same model, Link uses the one you added if exactly one was added. Otherwise it refuses and names the runtimes.

More than one key variable is set

Unset all but the one to use: Link doesn't choose whom to bill when your agent has no model yet.

"its fallback's key can't be kept on the wire beside its model's"

Fall back to a model of the same provider, on the same key, or keep keys in the harness (lnk agent secret agent).

"no model named ... runs on this machine"

A name after local/ goes only to this computer. Name a model lnk model list shows, or install it with lnk model install. A refused model selection leaves no new agent, including when start names a spec or create names a new agent. Choose a served model and run the command again.

"... is Anthropic's, and that key is OpenRouter's"

A model goes only where its name says, so a key for another provider is refused. Set the named provider's key, or name the model with the key's provider, such as openrouter/anthropic/claude-haiku-5.5 for an OpenRouter key.

"the model answered 400 ... does not support tools"

The model takes no tools. Pick a model that takes tools, or stop memory (Link Harness).

A model on your computer is slow, or ignores its notes and tools

A small model does, with memory on. Use a larger one, or a hosted one (Link Harness).

It forgets what was said earlier

Its window is full: set a larger [window] max in its spec, at a higher price per message.