Storytold

Local creative work. Native app engines. Verified file handoffs.

A Claude Code and Codex plugin for the open-source ArtCraft Craft App Suite: one craft Skill drives fifteen local, headless Craft MCP apps (photo, vector, video, RAW, PDF, layout, spreadsheets, documents, slides, CAD, audio, motion, interface design, procedural materials and 3D texture painting) through staged copies and verified exports.

English · Deutsch · Türkçe

Thank you, ArtCraft team! Storytold is built on the Craft App Suite, which the ArtCraft team released as free, open-source software: fifteen creative apps, each written from scratch. We're grateful for their generosity. None of this integration would exist without their work.

❤️ ArtCraft team 💚

Contents

• Overview
• Quick start
• The Craft App Suite
• Setting up the native apps
• Updating and removing
• Where things live
• Working safely
• Development
• Verification status
• Repository map
• License and affiliation

Overview

Storytold is Devsolux's local integration kit for the fifteen existing Craft CLI MCP servers. One compact craft Skill guides the host; each app keeps its own schemas, editing state, rendering and save semantics. Deterministic helpers install and pin the CLIs on explicit command, stage files, generate evidence-bound configuration and verify artifacts within stated limits.

User + Claude Code / local Codex
           │  one craft Skill; native tool discovery and approvals
           ├── stdio ── PhotoCraft, VectorCraft, FilmCraft, LightCraft
           ├── stdio ── PdfCraft, EffectCraft, DesignCraft, GridCraft
           ├── stdio ── WordCraft, DeckCraft, CADCraft, SoundCraft
           └── stdio ── FigCraft, MaterialCraft, TextureCraft
                                │
                      native engines → durable files

What it is

• One instructional Skill, fifteen on-demand app cards and two workflow guides.
• Fifteen direct, native stdio MCP registrations, one per app and host.
• A standard-library Python CLI (storytold.py) that installs, verifies, pins, probes and registers the Craft CLIs, but only when you run it.

What it is not

• No gateway MCP server, daemon, router or second AI agent.
• No bundled binaries: installing the plugin adds guidance, the reviewed release manifest and inactive templates, never executables, permissions or running MCP processes.
• No remote ChatGPT connector. Local Codex support is an additive packaging and configuration adaptation.
• No OS sandbox. See Working safely and SECURITY.md.

Quick start

1. Install the plugin. Repository devsolux/storytold, plugin storytold, marketplace devsolux-storytold. Both hosts take plugin@marketplace:

claude plugin marketplace add https://github.com/devsolux/storytold
claude plugin install storytold@devsolux-storytold

codex plugin marketplace add devsolux/storytold
codex plugin add storytold@devsolux-storytold

2. Install the native apps. From a clone, or from the installed plugin directory (<home>/plugins/cache/devsolux-storytold/storytold/<version>/ under ~/.claude or ~/.codex), set up one app or all fifteen:

python3 storytold.py setup --app photocraft

python3 storytold.py setup --all --acknowledge-unconfined

3. Start a new host session and use the Skill: /storytold:craft in Claude Code, or storytold:craft from the Codex Skill picker.

python3 storytold.py doctor reports, per app, the desktop app, CLI and host registration it finds and prints the exact setup command for anything missing, and the setup --upgrade command for an install behind its pin (registered_outdated); the Skill offers the same command in chat when a server is not connected.

The Craft App Suite

ArtCraft Launcher installs the Craft App Suite: free, open-source creative tools from the ArtCraft team, each written from scratch in Rust and each able to stand on its own. The File access column shows how Storytold launches each app's MCP server.

This is the beginning of the README. Read the rest at the original. Read the full README ↗