kdeps-tools-knowledge_note_save
v2.0.0Save a new note in the knowledge vault: one idea per note, with frontmatter (type, status, created, summary, tags, links). Refuses a title that already has a note - one home per fact, so edit that note instead. Use for a decision, a gotcha, a concept or a tool worth remembering beyond this session; it goes in the project's folder unless scope says otherwise. Status and next steps go to the card instead.
set tools / shelf memory
LLM context: ~316 tokens when loaded (prompt or tool definition)
Where it runs
Part of the tools set, used in workflow and agent mode. What the model is told about each built-in tool: its description, usage notes and parameters. kdeps runs the tool itself.
- the agent loop builds the request
- the tool definitions are sent to the modeltools/knowledge_note_save
- the model calls a tool
- kdeps runs it
- the result goes back to the model
Loaded by: kdeps (agent loop), /update, /settings, kdeps run, kdeps install, kdeps list, kdeps uninstall, kdeps update
In the code: kdeps (agent loop)agent.RegisterBuiltinToolsagent.definedAs
Install
A kdeps asset: installed with the first-run profile that includes its set, or the first time a command needs it, and updated without a new release.
Pin a version with kdeps install tools/knowledge_note_save@<version>.
Contents
Save a new note in the knowledge vault: one idea per note, with frontmatter (type, status, created, summary, tags, links). Refuses a title that already has a note - one home per fact, so edit that note instead. Use for a decision, a gotcha, a concept or a tool worth remembering beyond this session; it goes in the project's folder unless scope says otherwise. Status and next steps go to the card instead.
- category
- memory
| Parameter | Type | Description |
|---|---|---|
| title * | string | Note title (becomes the file name); no / \ : * ? " < > | |
| summary * | string | One line saying what the note holds; recall shows it before anyone opens the note |
| body * | string | The note's markdown body; link other notes with [[Note title]] |
| type | string | decision, gotcha, concept, tool or note (default note) |
| scope | string | project (default: the working directory's project - notes/, or decisions/ for type decision), shared (knowledge across projects) or inbox |
| tags | string | Comma-separated tags |
| links | string | Comma-separated titles of related notes, written as frontmatter links |
version: 2.0.0
category: memory
description: 'Save a new note in the knowledge vault: one idea per note, with frontmatter (type, status, created, summary, tags, links). Refuses a title that already has a note - one home per fact, so edit that note instead. Use for a decision, a gotcha, a concept or a tool worth remembering beyond this session; it goes in the project''s folder unless scope says otherwise. Status and next steps go to the card instead.'
parameters:
title:
type: string
description: 'Note title (becomes the file name); no / \ : * ? " < > |'
required: true
summary:
type: string
description: One line saying what the note holds; recall shows it before anyone opens the note
required: true
body:
type: string
description: The note's markdown body; link other notes with [[Note title]]
required: true
type:
type: string
description: 'decision, gotcha, concept, tool or note (default note)'
scope:
type: string
description: 'project (default: the working directory''s project - notes/, or decisions/ for type decision), shared (knowledge across projects) or inbox'
tags:
type: string
description: Comma-separated tags
links:
type: string
description: Comma-separated titles of related notes, written as frontmatter links
Versions
| Version | Published | Status |
|---|---|---|
| 2.0.0 | 10/15/2026 | active |
| 1.0.0 | 10/15/2026 | active |
Details
- Author
- kdeps
- License
- Apache-2.0
- Latest Version
- 2.0.0
- Published
- 10/15/2026