Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,16 @@

Thank you for your interest in contributing to KnowledgePlane! We welcome contributions from everyone, whether it is a bug report, feature request, documentation improvement, or code change.

## Areas We Need Help

We're a small team and appreciate contributions in these areas:

- **MCP tools** -- New tools for the MCP server, improved search/retrieval, better tool descriptions
- **Web dashboard** -- UI improvements, new views (graph visualization, timeline), accessibility
- **Documentation** -- Tutorials, integration guides, architecture deep-dives
- **Testing** -- Integration tests, edge case coverage, benchmark improvements
- **Integrations** -- Adapters for other AI tools and platforms beyond Claude Desktop

## How to Contribute

### Development Setup
Expand Down
26 changes: 25 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,20 @@

Knowledge Plane is an MCP server that gives AI agents and teams persistent, shared memory. It stores facts as a knowledge graph with vector embeddings, automatically consolidates related facts into knowledge cards, and provides hybrid search (vector + graph traversal). Native MCP protocol support means any MCP-compatible AI tool (Claude, Cursor, etc.) can read and write shared knowledge.

## Why Knowledge Plane?

Memory layers for AI exist (Mem0, Zep, Letta), but they're built around flat vector stores -- good for retrieval, less good for understanding how things relate. Knowledge Plane stores facts as a graph with typed relations, so "Alice manages Bob" is a first-class edge you can traverse, not a blob of text you hope cosine similarity resurfaces. Background workers continuously consolidate related facts into knowledge cards, building institutional knowledge instead of just accumulating embeddings. And it's designed for teams from the start: multi-workspace, multi-agent, multi-tool -- shared memory across your entire AI stack, not just one chatbot.

## How It Works

Your team runs AI agents across different tools -- a dev agent in the IDE, a PM agent in the browser, a support agent in Slack. On Monday, the dev agent learns that the payments API was refactored. On Wednesday, the PM agent is planning a sprint and needs that context. Without shared memory, it doesn't have it. With Knowledge Plane, the dev agent wrote that fact once, the consolidation worker linked it to the payments service card, and now any agent in any tool can find it through search or graph traversal.

## Open Infrastructure

Built on [MCP](https://modelcontextprotocol.io) (Model Context Protocol), the emerging open standard for AI tool integration. Fully self-hostable -- your knowledge stays on your infrastructure. Apache-2.0 licensed, no telemetry, no vendor lock-in. Your data, your rules.

Built by [Camplight](https://camplight.net), a cooperative of AI-native teams across Europe. Used internally to power knowledge sharing across [Juma.ai](https://juma.ai) and Slack-integrated marketing agents.

## Features

- **Persistent agent memory** -- Facts stored in ArangoDB knowledge graph with vector embeddings
Expand Down Expand Up @@ -123,9 +137,19 @@ knowledgeplane/
| [Environment Setup](./ENV_SETUP.md) | All environment variables |
| [API Specification](./docs/SPEC.md) | Complete API reference |

## Knowledge Plane Cloud

This repo is the self-hosted, DIY version. If you'd rather not manage the infrastructure yourself, [Knowledge Plane Cloud](https://knowledgeplane.io) offers a managed deployment with everything pre-configured. And if you need a full agentic memory overhaul -- integrating shared knowledge across your team's AI tools and workflows -- [Camplight](https://camplight.net) (the team behind Knowledge Plane) does that as a service.

## Contributing

We welcome contributions! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
We're actively looking for help with:
- **MCP tool coverage** -- adding new tools and improving existing ones
- **Dashboard UI** -- the web interface needs polish and new views
- **Documentation** -- guides, tutorials, and API docs
- **Testing** -- integration tests, edge cases, benchmark coverage

See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions and guidelines.

## License

Expand Down
Loading