Documentation Index
Fetch the complete documentation index at: https://docs.cowagent.ai/llms.txt
Use this file to discover all available pages before exploring further.
The personal knowledge base is the Agent’s long-term structured knowledge store, saved in the knowledge/ directory within the workspace. Unlike memory, which is organized by timeline, the knowledge base organizes content by topic — articles, conversation insights, and learning materials are structured into interlinked Markdown pages, forming a continuously growing knowledge network.
Core Concepts
Knowledge vs Memory
| Dimension | Knowledge Base (knowledge/) | Long-term Memory (memory/) |
|---|
| Organization | By topic, interlinked | By timeline, dated files |
| Writing | Agent actively structures content | Auto-summarized on context trimming |
| Content | Refined, structured knowledge | Raw conversation summaries |
| Use cases | Study notes, tech docs, project knowledge | Conversation history, event records |
Directory Structure
~/cow/knowledge/
├── index.md # Knowledge index, entry point for all pages
├── log.md # Change log, records each write
├── concepts/ # Conceptual knowledge
│ └── machine-learning.md
├── entities/ # Entity knowledge (people, orgs, tools)
│ └── openai.md
└── sources/ # Source knowledge (articles, papers)
└── llm-wiki.md
Automatic Organization
Knowledge writing is an autonomous Agent behavior, triggered in these scenarios:
- User shares an article or document — The Agent automatically extracts key information and creates a structured knowledge page
- Conversation produces valuable conclusions — The Agent organizes insights into knowledge pages and links them to existing knowledge
- User explicitly requests organization — Users can guide the Agent to organize and update knowledge through conversation
Each knowledge page includes cross-reference links to related pages, gradually building a knowledge graph.
Knowledge Retrieval
The Agent can retrieve knowledge during conversation through:
- Index lookup — Quickly locate relevant pages via
knowledge/index.md
- Semantic search — Search knowledge content via the
memory_search tool
- Direct read — Read specific knowledge files via the
memory_get tool
Web Console
The web console provides a dedicated “Knowledge” module with:
- Document browsing — Tree-style directory structure, searchable and collapsible, click to view content
- Knowledge graph — Interactive graph visualizing relationships between knowledge pages
- Chat integration — Knowledge document links referenced in Agent replies are clickable for direct navigation
CLI Commands
Manage the knowledge base with the /knowledge command:
| Command | Description |
|---|
/knowledge | Show knowledge base statistics |
/knowledge list | Display file directory as a tree |
/knowledge on | Enable the knowledge base feature |
/knowledge off | Disable the knowledge base feature |
Configuration
| Parameter | Description | Default |
|---|
knowledge | Whether to enable the personal knowledge base | true |
agent_workspace | Workspace path; knowledge is stored under the knowledge/ subdirectory | ~/cow |
