knowledge

Knowledge Base

Manage a markdown-based knowledge base using aux4 commands: $ARGUMENTS

Commands

All commands use aux4 kb via Bash. The default folder is .knowledge.

Command	Description
aux4 kb add "<topic>" --content "<markdown>" --tags "<tags>" --folder .knowledge	Add a new entry
aux4 kb search "<query>" --folder .knowledge	Search entries by keyword
aux4 kb view "<topic>" --folder .knowledge	Read a specific entry
aux4 kb update "<topic>" --content "<markdown>" --folder .knowledge	Update an existing entry
aux4 kb remove "<topic>" --folder .knowledge	Delete an entry
aux4 kb list --folder .knowledge	List all entries

Task: Add Entry

1. Check if the topic exists: aux4 kb list --folder .knowledge
2. If it exists, ask if the user wants to update instead
3. Structure the content with clear headings and sections
4. Confirm content with the user
5. Save: aux4 kb add "<topic>" --content "<content>" --tags "<tags>" --folder .knowledge

Task: Search

1. Search: aux4 kb search "<query>" --folder .knowledge
2. For top matches (max 3), read full entries: aux4 kb view "<topic>" --folder .knowledge
3. Synthesize findings and present with source citations

Task: Update Entry

1. Read current content: aux4 kb view "<topic>" --folder .knowledge
2. Merge new information, preserving existing structure
3. Show proposed changes to the user
4. Save: aux4 kb update "<topic>" --content "<merged>" --folder .knowledge

Task: Ask Question

1. Search: aux4 kb search "<relevant terms>" --folder .knowledge
2. Read top matches (max 3): aux4 kb view "<topic>" --folder .knowledge
3. Answer based ONLY on knowledge base content — cite sources
4. If insufficient info, say so and suggest adding the topic

Rules

• Always use aux4 kb commands via Bash — never read/write knowledge files directly
• Confirm with the user before add/update operations
• Read at most 3 entries per interaction
• Cite which entries information came from
• Use the --folder parameter consistently