Proposals tab is empty

~2 min read

Proposals tab is empty

You expected to see agent proposals but the Proposals tab (inspector) or ⌘⌥R review pane shows nothing.

#1: Agent’s key isn’t propose-only

The key has write/all scope without the --propose flag, so the agent applied its edits directly instead of proposing them. Look at the file — the changes may already be there. (Propose-only is a flag layered on a write key, not a scope of its own.)

Check: lettuce keys list — the key’s mode column shows propose only if it was created with --propose.

Fix: Re-issue the key with the flag: lettuce keys remove --label NAME then lettuce keys add --label NAME --scope write --propose. Going forward, the agent’s writes will queue as proposals.

#2: Wrong vault

The proposals pane shows proposals for the currently-open vault. If you have multiple vaults open and the agent wrote to a different one, you won’t see anything until you switch.

Check: Bottom-left status bar shows the active vault.

Fix: Open the right vault. The vault-wide review (⌘⌥R) shows proposals only for that window.

#3: Filter is hiding them

The proposals pane has a search box that may be filtering everything out (perhaps from a previous session).

Check: Clear the search box.

Fix: Clear it, or close and reopen the proposals view.

#4: Agent didn’t actually propose

Same as case #3 in Troubleshooting/01 Agent edits not appearing — the agent hallucinated. The fix is the same.

#5: .lettuce/proposals/ is missing or unreadable

If the folder was deleted or permissions got weird, proposals won’t show.

Check:

ls -la "$VAULT/.lettuce/proposals/"

Fix:

mkdir -p "$VAULT/.lettuce/proposals"
chmod 755 "$VAULT/.lettuce/proposals"

Restart Lettuce.

#6: Server isn’t running

Without the server, the agent never got the call through, so there’s nothing to display.

Check:

curl http://127.0.0.1:51234/health

Fix: Settings → General → Agent API server. Or lettuce serve.