- New: Report bugs and request features straight from the CLI — run
ck report --title "..." --body "..."to file a bug report or feature request without leaving your terminal. Pass a large diagnostic dump with--body-file <path>or pipe it in with--body -, and set--type bug|feature|ideaif you like. Your report shows up on your Support page where you can follow the conversation, and your Claude Code agent can file one for you when it hits a wall.
Changelog
What's New
Everything we've shipped, as it happens.
- New: We'll tell you when a book you asked for arrives — when your agent searches for something your library can't answer, CandleKeep now remembers that you asked. If we later add a book that fills that gap, you'll get a heads-up right in your terminal the next time you run
ck, with a one-line command to add the new book to your library. - New: Compare CandleKeep to other tools — new comparison page covering Obsidian, NotebookLM, Notion, Glean, and building your own RAG at /compare
- New: Manage your team from the CLI — owners and admins can now run the whole team admin flow in the terminal with
ck team: create departments, invite people, add them to departments, and grant or scope documents (team-wide or to a single department) with read or write access. Runck team access matrixto see who can read what. Your Claude Code agent can do it conversationally too — "add the onboarding handbook to the Engineering department" just works. - Improved: Clearer no-terminal setup for Claude Desktop & Cowork — the install page now leads with the no-terminal path so chat-based agents and Desktop/Cowork users aren't sent to a terminal command that doesn't apply to them, and the Cowork guide has a plain-text "Copy-paste version" you (or Claude) can follow without screenshots. Added troubleshooting for when behaviour seems stale after an update — re-download the skill bundle to refresh it.
- New: Per-seat Team plan — the Team plan is now $30 per seat, and you buy exactly the number of seats you need: invite a co-founder for 2 seats or roll out to a 50-person org, you only pay for the people on the team. Add or remove seats anytime, and manage billing from the team page.
- New: Shared team manuscripts — your whole team's agents can now read from a shared, living knowledge base. When one engineer finishes a refactor and their agent writes up what changed, that knowledge lands in the team's shared manuscript — so the next teammate's agent starts from what the team already learned instead of from scratch.
- New: Team admin panel with department-based access — owners and admins get a dedicated panel to organize members into departments and grant specific books to specific departments. Share a book with the whole team, or scope it to just Engineering or just Sales, and each member's agent only ever sees the books they're cleared for. An access matrix shows at a glance which departments can read which documents.
- New: Connect MCP clients with your API key — the CandleKeep MCP server now accepts your
ck_API key as a Bearer token, so you can wire up any MCP client directly without the OAuth connector flow. Grab a key on the Developers page, where there's now a copy-paste MCP setup section. - Improved: The team page now shows live seat usage so you always know how many seats are in use versus purchased before you invite someone new.
- Fixed: LLM Wiki auto-updates now actually write — Claude Code was silently blocking the wiki write in auto mode;
ck setup(and the background updater) now grant the needed permissions - Fixed: Agents can now locate your wiki manuscript reliably — the session context includes the manuscript ID and
ck ms showaccepts the book ID as a fallback - Fixed: The Windows install one-liner (
irm https://getcandlekeep.com/install.ps1 | iex) now works in Windows PowerShell — it previously crashed immediately before installing anything - Fixed: CLI downloads no longer fail on slower connections — the installer and auto-updater now allow slow-but-progressing downloads to finish, retry transient network errors automatically, and show clearer error messages when a download truly can't complete
- New: Share your library — make any book public from its ⋯ menu, then share your reading list. Your public profile page at getcandlekeep.com/share/you now shows the books you've added to your showcase, and the share dialog can copy your list as a clean markdown table to paste into a gist, README, or post. Books are private by default — only the ones you add to your showcase ever appear.
- New: LLM Wiki — your library now includes an auto-maintained "My LLM Wiki" book that your coding agent updates on its own after each session, capturing the concepts, decisions, and patterns you work through so your knowledge compounds over time. No approval prompts — the agent writes it and posts a one-line note, and every change is reversible from version history.
- New: Auto-update for any manuscript — switch on "Auto-update" for a manuscript (in the dialog, or with
ck ms create/update --auto-update) and your agent maintains it automatically at the end of each session instead of asking you to approve every addition. - New: Per-manuscript writing instructions — give any manuscript its own instructions for how the agent should write and structure it — tone, layout, what to include, how to link pages — and the agent reads and follows them. View them anytime with
ck ms show <id>. - New: Control when CandleKeep activates in plan mode — a new Settings page lets you choose how the skill triggers while you plan: Always (check your library every time), Smart (only when your library likely covers the task), Ask (confirm first), or Off. Set it in Settings or from the terminal with
ck config set skill.planMode <mode>, and it applies to your next session — no reinstall needed. Already-activated power users can dial it down; the default stays Always. - Fixed: Books shared with you or subscribed from the marketplace no longer show the original owner's private shelf names. Your library and
ck items listnow only ever display shelves you created yourself. - Fixed: Subscribed books no longer surface the owner's private team name in your dashboard.
- New: New tier names: Personal and Professional — Free is now called "Personal" and Pro is now called "Professional" across the app, pricing page, and CLI. Same product, clearer identity.
- New: New pricing for new signups — Personal is $0/month with 5 items and 100 agent reads per month, plus 1 manuscript. Professional is $19/month with everything you had on Pro: unlimited reads, 200 items, marketplace publishing, unlimited manuscripts.
- New: Existing users keep their plan — if you signed up before today, your limits and price are locked. Free users still have 20 items and 500 reads per month. Pro subscribers stay on $10/month. Nothing changes for you.
- Improved: The trial-expired modal and billing page now show the right limits for your account — old accounts see their original caps, new accounts see the new Personal caps.
- New: One install hub for every surface — visit /install to pick how you'll connect: macOS/Linux one-liner, native Windows PowerShell, no-terminal Cowork/Desktop, or browser-only. The page auto-detects your OS (and defaults mobile visitors to the browser tab) so you see the right command first, but all four paths are visible side-by-side.
- New: Help drawer in the dashboard — click the new help button in the dashboard header, or press
?anywhere, to open a quick panel with install links for other surfaces (including a copy-pasteable prompt you can send straight to your AI agent), common tasks (upload, invite, marketplace, manuscripts), and resources (Slack, support, what's new). - New: CandleKeep in Claude Cowork & Desktop — paste one URL, upload one zip, and Claude can search your library, read pages with citations, and draft knowledge docs. No terminal needed. Walkthrough at /help/cowork.
- New: Promote any book to a manuscript — every book in your library now has a "Promote to Manuscript" button on its detail page. Turn an existing book into a living manuscript without creating a duplicate. Same on the CLI:
ck ms create "Title" --item-id <book-id>. Reattaching to a book that has an archived manuscript on it just works — the archived one quietly steps aside, keeping its topics and criteria intact. - New: Codex CLI integration — if you use OpenAI Codex CLI,
ck setupnow provisions a Codex-tuned skill plus four parallel subagents (librarian, reader, writer, enricher) optimized for GPT-5.5. Codex can spawn library research as a fan-out — librarian picks the books, multiple readers extract findings in parallel, you get a cited synthesis. - New: New
/marketplace/activitypage shows recent book additions and updates across the marketplace. - New: Screenshots in support tickets — attach images to new tickets and replies, or paste a screenshot directly into the message. Up to 4 images per message, PNG/JPEG/WebP/GIF, 10MB each.
- Improved: Windows and Cowork are first-class install paths now — both used to live as footnote links on the landing page; they're equal options in the install hub, the onboarding wizard, and the new help drawer. The "Getting Started" sidebar entry was renamed to "Install Guide" and points at the new hub.
- Improved: /install and /help pages now show the site nav — the install hub and the Cowork/Windows guides used to look stranded; they now have the same header as the rest of the marketing site, so the logo, marketplace, blog, and dashboard are always one click away.
- Improved: Cowork install screenshots zoom on click — the four Customize-panel screenshots in the Cowork install guide (and the preview on /install) open at near-fullscreen so you can actually read the labels. Esc or click the backdrop to close.
- Improved: Smarter agent-install prompt — the copy-pasteable "send this to your AI agent" line on /install and in the dashboard help drawer now points the agent straight at https://getcandlekeep.com/install, so it can read the install steps for your environment and run them, instead of guessing what "set up my library" means.
- Improved: Large books can be edited again — books that grew past the request body limit can now be updated using the new
ck items appendcommand, which sends only the new chapter instead of the entire book. Useck items append <id> --file chapter.mdto add at the end, or--prependto add at the start. Existingck items putstill works for smaller documents. - Improved: Books in your library now tell your agent when they've been updated — your agent will note what changed (new chapter, removed section, refreshed content) before answering from the book.
- Improved: OpenAI Prompting Best Practices book updated — new Chapter 12 on Codex CLI on-disk conventions (skills, subagent TOMLs, AGENTS.md), plus surgical updates to Ch. 3 (GPT-5.5 availability constraint), Ch. 5 (Personality variants), Ch. 7.9 (SDK vs CLI Skills), and Ch. 11 (Codex CLI subagents).
- Improved: CandleKeep activates proactively in Codex — for code review, UI/UX critique, design feedback, security audits, architecture decisions, and "find improvements" / "research X" queries, the librarian fires as Codex's first action and grounds the answer in your library rather than going to the web. Matches the Claude Code behavior you're already used to.
- Fixed:
ckno longer crashes when run from inside Codex's read-only sandbox — previously you would see a Rust panic ("Attempted to create a NULL object") on the firstck items listfrom a Codex session. The CLI now uses a pure-Rust TLS stack and fails gracefully if network is blocked. - Fixed: Upgraders no longer see a duplicate
candlekeepskill in Codex's/skillslist — the deprecated install path (~/.codex/skills/candlekeep/) from earlier CLI versions is now cleaned up when you re-runck setup. - Fixed: Activity graph tooltip on top row — hovering Sunday cells no longer cuts off the tooltip.
- New: Book suggestions on library miss — when your agent searches for a topic not covered by your library, it now suggests a real book that would help and remembers what it suggested so it won't repeat itself
- New: Sharing on social and search just got better — links to blog posts, marketplace listings, and the home page now render with proper preview cards on Twitter/LinkedIn/Slack, and search engines see structured data (Article, Product, Organization) so results show richer snippets
- Improved: Cleaner page titles in browser tabs and search — tightened the home title and meta description so they fit Google's display caps and lead with what CandleKeep does for you, not what it is
- New: Writer Analytics — marketplace authors can now see how their published books perform: weekly read rate, unique readers, chapter-level heatmap showing which sections agents reference most, and channel breakdown (CLI vs Plugin vs Web). Privacy-first design hides granular breakdowns until 5+ unique readers.
- Improved: More reliable ingestion for long books — large, formatting-heavy PDFs and EPUBs (1000-page references, technical AI/RAG books, finance manuals) that previously timed out during processing now ingest to completion. Markdown structure is preserved — headings, tables, lists, code blocks, and italics survive intact instead of being lost to a plain-text fallback.
- Improved: Resumable ingestion — if a worker restarts mid-upload (during a deploy or transient infra issue), your book picks up from the pages already extracted instead of starting over.
- New: Manuscripts — define knowledge areas and your coding agent automatically proposes book additions at the end of sessions based on what it learned
- New: Manuscripts feature discovery across the app — contextual cards, sidebar badges, and educational content to help you get started
- Fixed: Archived manuscripts no longer count toward your billing quota
- Fixed: PRO pricing copy now accurately reflects available features — removed references to unimplemented revenue sharing and team features
- New: CLI now supports headless login via
ck auth login --with-tokenfor SSH, CI, Docker, and Codespaces environments - Improved: Marketplace search bar is now always visible and larger — no longer hidden until you enter the All Books view
- Improved: CLI setup and webapp onboarding now showcase the full marketplace catalog so you can discover relevant books immediately
- New: One-click email unsubscribe with CAN-SPAM/GDPR compliance — native support in Gmail and Apple Mail
- New: Trial transparency — persistent banner showing days remaining, expiration countdown modal, and clear upgrade path
- Improved: Onboarding redesigned around automatic activation — CandleKeep now fires during plan mode without manual setup steps
- Improved: Free tier read limit errors now include a direct link to upgrade
- Fixed: Table of contents no longer shows expand buttons for chapters without sub-sections
- Fixed: Skill cache now refreshes immediately after admin updates
- New: Librarian agent — automatically finds relevant books from your library and the marketplace during plan mode, no manual browsing needed
- New: Research pipeline now follows a focused librarian-then-reader flow for more precise results
- Improved: Plan mode integration streamlined to a single research phase
- Improved: CandleKeep activates reliably in plan mode via improved skill routing
- Fixed: Team plan users are no longer incorrectly downgraded when their trial expires
- Fixed: Team subscriptions now recognized across all billing checks and feature gates
- New: Windows CLI support — CandleKeep CLI now runs natively on Windows via PowerShell, no WSL required
- New: Citation block — agents now cite exactly what they read and how it influenced their answer, with a "Worth remembering" quote for gradual learning
- New: Structured citation block appears at the end of research-informed responses
- Improved: Research costs reduced by 80% with no loss in accuracy (Sonnet replaces Opus for reading)
- New: Marketplace redesign — magazine-style layout with visual book covers, category-based color palettes, and editorial featured book sections
- New: Book table of contents now shows page ranges for each chapter and section (e.g., "Chapter 1 (p. 5–11)")
- Improved: Marketplace shows "In Library" badge for books you already own
- Improved: New users can now sign up directly from the CLI authentication page
- New: CandleKeep now activates automatically during planning and architecture tasks
- New: Your library and marketplace catalog are injected at the start of every Claude Code session
- Improved: Research sessions are now tracked for better context continuity
- New: Create, edit, and manage markdown documents alongside PDFs
- New: New Book Writer agent creates and edits documents through natural conversation
- Improved: Library view now shows markdown documents alongside PDFs
- New: Books with missing metadata are now automatically enriched with titles, authors, and descriptions
- New: Table of contents extraction for easier navigation within books
- Improved: Library view now shows enrichment status and a queue of items needing review
- New: CandleKeep Cloud launches with document library, AI-powered research, and CLI access
- New: Search your library and get cited answers from your books
- New: Upload PDFs and manage your knowledge library from the command line