Tools Reference

All tools operate on the .ai-knowledge store under the configured --root directory.

warning

Topic naming rules

Topics must not contain / or \\, and cannot be . or ...

recall_general_memory

Recalls the general project memory from the index.

Input: None
Output: Plain text content from index.mdk

recall_memory

Recalls detailed memory for a specific topic.

Input

Field	Type	Required	Description
topic	string	yes	The topic to recall.

Output

Markdown that includes the topic title, tags, last updated date, and content.

search_memories

Searches memories by tags.

Input

Field	Type	Required	Description
tags	string[]	yes	Tags to match (case-insensitive).

Output

A list of matching topic names or a "No topics found" message.

list_memories

Lists all available memory topics.

Input: None
Output: A comma-separated list of topic names.

memorize_new_topic

Memorizes a new topic and updates the index.

Input

Field	Type	Required	Description
topic	string	yes	Topic name for the new memory.
tags	string[]	yes	Tags to associate with the topic.
summary	string	yes	1-2 sentence summary used in the index.
content	string	yes	Full Markdown content for the topic.

Behavior

Fails if the topic already exists.
Writes <topic>.mdk and updates index.mdk.

refine_memory

Refines an existing memory and updates the index.

Input

Field	Type	Required	Description
topic	string	yes	Topic to update.
tagsToAdd	string[]	no	Tags to add.
tagsToRemove	string[]	no	Tags to remove.
newSummary	string	no	Replacement summary for the index.
newContent	string	no	Replacement Markdown content.

Behavior

Updates tags and last_updated timestamp.
Updates the index summary when newSummary is provided.

memorize_general_info

Memorizes or updates the general project information.

Input

Field	Type	Required	Description
content	string	yes	Markdown content for the general section.

Behavior

Replaces the "General Project Knowledge" section in index.mdk.
Rejects content that includes the "Specialized Knowledge" header.

forget_memory

Forgets a memory topic and removes it from the index.

Input

Field	Type	Required	Description
topic	string	yes	Topic to remove.

Behavior

Deletes <topic>.mdk when possible.
Always removes the topic summary from index.mdk.

Experimental Tools

warning

Requires --experimental flag

The tools below are only available when the server is started with the --experimental flag.

outline_symbol

Returns the relation tree for a named symbol, showing all its connections across the codebase.

Input

Field	Type	Required	Description
symbol	string	yes	Symbol name to look up (e.g. `RegisterExtractor` or `outline.(*OutlineManager).RegisterExtractor`).
language	string	yes	Target language (e.g. `go`).
file	string	no	Restrict the search to a single file (relative path from project root).
depth	integer	no	Levels of relations to traverse. Default: `2`.
relations	string[]	no	Filter to specific relation kinds (see Code Outline).
omit_native	boolean	no	When `true`, omit standard-library and built-in symbols.
format	string	no	`text` (default) or `json`.

outline_file

Returns the relation tree for every symbol declared in a source file.

Input

Field	Type	Required	Description
file	string	yes	Relative path to the source file.
language	string	yes	Target language (e.g. `go`).
depth	integer	no	Levels of relations to traverse. Default: `2`.
relations	string[]	no	Filter to specific relation kinds.
omit_native	boolean	no	Omit standard-library and built-in symbols.
format	string	no	`text` (default) or `json`.

outline_project

Returns the full relation tree for every symbol across the entire project.

Input

Field	Type	Required	Description
language	string	yes	Target language (e.g. `go`).
depth	integer	no	Levels of relations to traverse. Default: `2`.
relations	string[]	no	Filter to specific relation kinds.
omit_native	boolean	no	Omit standard-library and built-in symbols.
format	string	no	`text` (default) or `json`.