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, 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.
  • 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.
  • 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.
  • 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, 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.
  • 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.