Features
Everything your agents need to stay in context.
Ceiling is built around one idea: agents should start every task with full awareness of the project — its architecture, active priorities, past decisions, and relevant code. These are the tools that make that possible.
Knowledge
Vaults
Connect a GitHub repo and ceiling automatically indexes every file into a structured knowledge base. Pages are organized by entity (classes, functions, modules), concept, and source — with full content and embedding-based search.
Automatic indexing
Push to GitHub and ceiling re-indexes changed files. Embeddings are computed incrementally, so only changed chunks are re-processed. Your vault stays fresh without manual effort.
Hybrid search
Every search runs both semantic (vector cosine) and keyword (BM25-style) retrieval, then fuses results by rank. Returns ranked passages with source path, heading trail, and page number so agents can cite precisely.
Context
Context pages
Each vault has a living context page with structured sections: Project Summary, Active Priorities, Constraints, Recent Decisions, Known Risks, and Read First. Agents update these sections as they work.
Context subpages
Deeper history lives in subpages: architecture, decisions, security, incidents, open questions, and change log. Agents append timestamped entries via update_context_subpage — building a permanent audit trail.
Session summaries
At the end of every coding session your agent calls save_session_summary. The summary is stored as a wiki page in the vault, so future sessions have full history of what was done and why.
MCP integration
One-command install
Run npx ceiling-mcp, paste your API key, and ceiling is wired into Claude Code and Cursor. No manual JSON editing. The installer detects which editors are present and writes the correct config for each.
get_task_context
The most important tool. Given a task description, it builds a context pack: project summary, relevant wiki pages, recent decisions, related source passages, and constraints. Call it at the start of every session.
Full tool suite
list_projects, select_project, search, get_page, list_pages, get_task_context, update_context_page, compact_context_page, update_context_subpage, save_session_summary — everything an agent needs to stay oriented.
Research
Deep research reports
Run a research query grounded in your vault and the web. Ceiling searches the vault for relevant pages, optionally fetches live web results, and synthesizes a cited report stored persistently for your team.
Ready to try it?
Open source and free to self-host. Or sign up and start in two minutes.