Skip to content

Default locations for agent memory and skills, with a remember tool#47

Merged
wfaderhold21 merged 2 commits into
mainfrom
topic/agent-skills
Jul 18, 2026
Merged

Default locations for agent memory and skills, with a remember tool#47
wfaderhold21 merged 2 commits into
mainfrom
topic/agent-skills

Conversation

@wfaderhold21

Copy link
Copy Markdown
Owner

Skills previously worked only if ~/.config/linkshell/skills happened to exist, and the orchestrator had no persistent memory at all. Now both have defined default locations created automatically when an orchestrator starts:

~/.config/linkshell/skills/ (override: [orchestrator] skills_dir)
~/.config/linkshell/memory.md (override: [orchestrator] memory_file)

Memory is one markdown file, injected verbatim into the orchestrator's prompt every turn (API class) or pointed to by path in the CLI-class briefing. The agent appends short dated bullets via a new remember tool; the user curates the file by hand. Keeping it concise is deliberately the user's job — the file is plain markdown, trivially prunable — but the contract is enforced at the edges: past 8 KiB the prompt injection truncates and the agent is told to ask the user to prune, and remember replies include the file size with a warning past the same threshold. memory.md is seeded with a template explaining all of this.

remember joins the default auto_approve set (it writes only to the agent's own memory file), and the tilde expansion previously local to skills_path is factored into a shared helper used by both paths.

Tests cover the remember->inject roundtrip (including newline flattening and dated entries), empty-file suppression, the auto-approve default, and the dependency-free date helper.

wfaderhold21 and others added 2 commits July 18, 2026 16:20
Skills previously worked only if ~/.config/linkshell/skills happened to
exist, and the orchestrator had no persistent memory at all. Now both
have defined default locations created automatically when an
orchestrator starts:

  ~/.config/linkshell/skills/     (override: [orchestrator] skills_dir)
  ~/.config/linkshell/memory.md   (override: [orchestrator] memory_file)

Memory is one markdown file, injected verbatim into the orchestrator's
prompt every turn (API class) or pointed to by path in the CLI-class
briefing. The agent appends short dated bullets via a new `remember`
tool; the user curates the file by hand. Keeping it concise is
deliberately the user's job — the file is plain markdown, trivially
prunable — but the contract is enforced at the edges: past 8 KiB the
prompt injection truncates and the agent is told to ask the user to
prune, and `remember` replies include the file size with a warning past
the same threshold. memory.md is seeded with a template explaining all
of this.

`remember` joins the default auto_approve set (it writes only to the
agent's own memory file), and the tilde expansion previously local to
skills_path is factored into a shared helper used by both paths.

Tests cover the remember->inject roundtrip (including newline
flattening and dated entries), empty-file suppression, the auto-approve
default, and the dependency-free date helper.
@wfaderhold21
wfaderhold21 merged commit 022ed6c into main Jul 18, 2026
2 checks passed
@wfaderhold21
wfaderhold21 deleted the topic/agent-skills branch July 20, 2026 19:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant