Releases: lkuczborski/Codeck
v0.4
Codeck v0.4 focuses on faster deck creation, smoother slide workflows, and safer live Codex sessions.
Highlights:
- Adds a slide template picker with rendered previews.
- Expands the starter template catalog for structure, analysis, storytelling, workshops, and Codex demos.
- Starts new decks and slides with an editable title prompt and focuses the editor cursor where typing should begin.
- Improves slide command state, sidebar deletion, duplication, and template insertion flows.
- Tightens Codex session sandboxing.
- Expands coverage across deck parsing, templates, session runner, model settings, syntax highlighting, YAML, presentation state, and editor operations.
Validation: swift test passes with 134 tests.
v0.3
Codeck MCP is here!
This release introduces Codeck's MCP support so agents can create, inspect, and edit Codeck decks.
What's New
- Added the
codeck-mcpstdio MCP server for file-based.mdeckworkflows. - Added the live Codeck MCP bridge for editing open app windows over localhost Streamable HTTP.
- Added a disabled-by-default preference for the live bridge in Codeck's MCP settings.
- Added MCP tools for deck creation, reading, validation, slide edits, deck settings, and Codex block insertion.
- Added live-only tools for listing open decks, selecting slides, and starting or stopping presentation mode.
- Added MCP resource templates for file and live decks:
codeck://file/deck{?path,view,index}codeck://live/deck/{document_id}{?view,index}
Using the File MCP Server
The archive includes codeck-mcp next to Codeck.app. Use it with an MCP client over stdio:
CODECK_MCP_ALLOWED_ROOTS="$HOME/Documents:/tmp" ./codeck-mcpCODECK_MCP_ALLOWED_ROOTS limits which directories the server may read and write. It accepts a colon-separated list of roots.
Using the Live Bridge
- Open Codeck.
- Open Codeck settings.
- Enable MCP > Live Bridge.
- Configure your MCP client with a Streamable HTTP server named
codeck:
[mcp_servers.codeck]
url = "http://127.0.0.1:49747/mcp"Agents can then call list_open_decks, use the returned document_id, and edit the currently open deck.
Artifact
Codeck-v0.3-macos-universal.zip- SHA-256:
df36504dc7f4cb8f49155a1fcc1f395127e8f0e8395f7bdc94d535f496bf82fc
The app and CLI in this archive are ad-hoc signed but not notarized.
v0.2
Codeck 0.2 turns the editor into a much stronger Markdown deck authoring surface: highlighted code fences, insert and formatting controls, automatic slide splitting, and a polished appearance switcher.
Download
Codeck-v0.2-macos-universal.zipcontainsCodeck.appfor Apple Silicon and Intel Macs.- Unzip it and open
Codeck.app. The app is ad-hoc signed but not notarized, so macOS may show an unidentified-developer prompt on first launch. Codeck-v0.2-macos-universal.zip.sha256contains the SHA-256 checksum.
Highlights
- Added syntax highlighting for fenced Markdown code blocks. Add the language after the opening fence, for example
```swiftor```json. - Supported highlighting now covers Swift, JavaScript/TypeScript, Python, shell, JSON, YAML/TOML, HTML/XML, CSS, Markdown, diff, SQL, Rust, Go, Java/Kotlin, C/C++/Objective-C/C#, Ruby, and PHP.
- Added
Examples/SyntaxHighlighting.mdeck, a demo deck that showcases the highlighting styles across languages. - Replaced the old Codex-session-only insert button with an Insert menu for common Markdown elements, including headings, paragraph text, links, lists, block quotes, tables, horizontal rules, images, code blocks, and Codex sessions.
- Added dedicated Markdown formatting buttons for bold, italic, inline code, strikethrough, and links. Buttons show active state for the current selection, and when there is no selection they apply to the current styled span or word around the cursor.
- Fixed slide delimiter handling so a line containing only
---splits the deck into separate slides, updates the sidebar, and creates/selects a new slide when typed in the editor. - Tightened fenced-code parsing to follow strict Markdown closing-fence rules, so accidental text after backticks does not close a code block and slide separators inside code stay inside code.
- Fixed editor binding when switching slides, so edits apply to the visible selected slide instead of sticking to the first slide.
- Added a persistent Light/Dark/Automatic app appearance selector. Automatic now follows the system appearance correctly.
- Tidied toolbar layout with separated appearance, play, and preview-sidebar controls, plus a prominent play button.
Requirements
- macOS 14 or later.
- Codex CLI on
PATHwith an active login for live Codex sessions.
Validation
- Built
Codeck-v0.2-macos-universal.zipfrom commitd466015with a universal release binary forarm64andx86_64. codesign --verify --deep --strictpassed forCodeck.app.- The release zip was extracted and the extracted
Codeck.apppassedcodesign --verify --deep --strict. swift testpassed on April 29, 2026 at commitd466015: 56 tests, 0 failures.
v0.1
Codeck 0.1 is the first release of Codeck, a native macOS document-based Markdown presentation maker for teaching Codex prompting workflows.
Download
Codeck-v0.1-macos-universal.zipcontainsCodeck.appfor Apple Silicon and Intel Macs.- Unzip it and open
Codeck.app. The app is ad-hoc signed but not notarized, so macOS may show an unidentified-developer prompt on first launch. Codeck-v0.1-macos-universal.zip.sha256contains the SHA-256 checksum.
Highlights
- Create and edit
.mdeckMarkdown slide decks with YAML front matter for deck metadata, themes, and Codex defaults. - Present decks full-screen from the selected slide with keyboard navigation.
- Run live Codex sessions from fenced
codexblocks usingcodex app-server, with per-block run controls, slide-level run all, and streamed Markdown responses. - Fetch available Codex models and reasoning options dynamically while preserving future model metadata in saved decks.
- Use the split editor, slide sidebar, preview visibility toggle, compact window layout, Liquid Glass interface, bundled app/document icons, and README screenshot.
- Render Codex output cleanly, including headings, lists, tables, code, links, and images.
- Ship with an MIT license.
Requirements
- macOS 14 or later.
- Codex CLI on
PATHwith an active login for live Codex sessions.
Validation
- Built
Codeck-v0.1-macos-universal.zipfrom commite07de27with a universal release binary forarm64andx86_64. codesign --verify --deep --strictpassed forCodeck.app.swift testpassed on April 27, 2026 at commite07de27: 32 tests, 0 failures.