Curio CLI Release Notes

Updates, improvements, and fixes for the Curio command line tool.

v1.0.0

Curio CLI 1.0

Requires macOS 15.0+ · Curio 34.0 (34001)+

Curio CLI 1.0 brings Curio automation to Terminal, scripts, and AI clients with structured JSON output, live app automation, and read-only direct project access.

New Features

  • Full Command Suite: Added query, get, set, fields, tags, sections, assets, status, create, move, batch, export, import, navigate, save, update, settings, skills, claude, and mcp-server commands.
  • Live App and Direct Project Modes: Talk to the running Curio app for selection-based and read/write workflows, or use --project to inspect .curio files directly in read-only mode.
  • Project Automation: Query with Curio's Search and Quick Find language, read and update figure or Organizer item fields, create sections and idea spaces, move figures or Organizer items, and navigate by URL, path, UUID, or identifier. Navigating to an already-open project makes it current for subsequent commands, and newly saved projects support section-addressed creation and imports immediately without a close-and-reopen cycle. The parent_id field provides direct hierarchy read-back, separate absolute section_path and organizer_path fields describe their distinct hierarchy namespaces, recursive Organizer-order listings include a descendant-aware total_count, and the save command provides a synchronous persistence barrier for the current project or an open project selected by UUID.
  • Import and Export: Export figures and idea spaces to PNG, JPEG, PDF, text, Markdown, or RTF; import files, stdin content, structured lists, mind maps, stacks, tables, synced content, and Spread PDF page sets. Markdown text imports render automatically, and a plain title line followed by a blank line names an imported Markdown collection. Spread PDF imports persist every populated page drawing before the command returns, including workflows that immediately close the project from a script.
  • AI Client Integrations: Bundled Curio skills for Claude Code, Codex, Antigravity CLI, Antigravity app, and Agents, plus the curio-mcp reference skill for legacy or manual hosts. Running-app guidance requires host execution for macOS IPC, retries inconclusive status checks outside restricted sandboxes, and prevents agents from launching Curio based on an unverified result.
  • MCP and Claude Connector: Added a stdio MCP server with Curio tools, docs, resources, and workflow prompts, plus claude install, claude package, and claude doctor commands for the packaged Claude Desktop MCPB connector.

Technical

  • Self-Documenting CLI: Extensive built-in help, field detail lookup, settings management, command examples, JSON responses, JSONL batch output, and clear exit codes make the CLI practical for both humans and scripts.
  • Skill Installers: Skills can be installed, uninstalled, listed, or revealed with curio skills, including --all auto-detection and safe symlink management that avoids overwriting existing user files.
  • Update Policy: The CLI checks for newer releases, reports grace-period status in interactive terminals without polluting routine machine invocations, verifies downloaded installers by checksum, signature, and Gatekeeper assessment, and enforces minimum compatible Curio app versions.
  • Structured Field Model: Figure and Organizer item fields use snake_case names, report writability through curio fields, and support focused updates through named flags, key=value pairs, JSON objects, files, or stdin. Section and Organizer paths are separate absolute title paths that preserve complete titles, and bulk asset sorting caches each path once for better performance on large projects.
  • Sandbox-Aware Workflows: Status reports sandbox state and accessible folders so scripts can stage imports correctly for the Mac App Store edition while still supporting unrestricted paths in the website edition.