craft-anything README

项目的 README,来自 github.com/storytold/craft-anything。合并为一个 markdown 文件:README.md。

ArtCraft

Craft Anything icon: an engraved raven on a blue tile

Craft Anything

English · 日本語 · 简体中文 · 繁體中文 · 한국어 · Español · Français · Tiếng Việt · Português · ไทย · Türkçe

See how any website, app or game works, then have AI build your own version; an open-source, clean-room engine in pure Rust.
Point it at a target, say what you want, and it studies the original with real inspection tools,
has a coding agent build a new project, checks the result against the original and refines it.

100% Rust macOS · Windows · Linux · FreeBSD · Web License: MIT OR Apache-2.0 Status: early alpha
Scanned by SonarCloud Reviewed by CodeRabbit

Join the ArtCraft community on Discord

Download Craft Anything · ArtCraft · All Crafting Apps


A website project in Craft Anything: the check lists what doesn't match yet and how alike each page is, the builder says its version is ready, an approval card asks before running a command, and the plan shows two of four steps done
A website project: each check says how alike the build is, you approve anything outside the rules, and the plan shows what's left.

[!NOTE] ArtCraft is a community of artists from all walks of life. Painters, photographers, filmmakers, illustrators, designers, animators, hobbyists, and people who picked up a pencil last week. If you make things, you're one of us. Come say hi on Discord.

How it works · Two ways to use it · AI · Agents · Under the hood · Get started · Status · Downloads · Discord


🔍 Study anything

Websites, desktop apps, phone apps, games and files: real inspection tools find out how they're built and what they do, with the evidence behind every answer.

🛠️ Build your own

Say what you want ("Recreate this website", "Recreate this game's gameplay in Rust") and a coding agent builds a new project in the stack you ask for.

✅ Checked, not guessed

Every build is compared with the original (pages at three screen widths, a game's own self-test, an app's runs) and refined until it's close.

🤖 Agent-ready

320 tools, each one a CLI command and an MCP tool, so any agent can drive the same engine the app uses. No AI is needed to inspect.

How it works

Point Craft Anything at a target, say what you want, and press Start. It works in four steps, asking you in plain words when a decision is yours:

  1. Study: inspect the original: its pages at every width, its code, its files, how it runs.
  2. Build: a coding agent builds a new project, in the language, framework or engine your request names (or a sensible default).
  3. Check: compare the build with the original and list what doesn't match yet.
  4. Ready: open, play or preview the result, or ask for changes and it refines it.
The Make screen: pick a website, an app or a game to recreate, type the address, choose Clean room or Deep, say what you want and press Start
Make: pick what to recreate, say what you want, press Start.
A finished snake game project with its steps all done and a Play the game button
Ready: play the game, or ask for changes below.

Two ways to use it

Both modes drive the same engine.

Clean room or Deep

Clean room is a rule about what Craft Anything offers and refuses. It is not an operating-system sandbox: it doesn't isolate your computer. A coding agent you run still acts as you, and what it can read, write or run depends on its own permissions. Which of an agent's own tools Craft Anything can refuse differs by agent; for Claude Code's tools in chats and questions, see docs/claude-code.md.

Switch in the title bar or Settings, with settings_set deep_mode true, or for one CLI run with --deep (or --clean-room).

The Advanced workbench: a function list, pseudo-C of the selected function, the agent answering a question with a tool call, and the evidence ledger
Advanced: functions, pseudo-C, the agent and the evidence behind every answer.

AI

Building needs a coding agent on your computer. Claude Code is supported first: Craft Anything runs your own, unmodified claude program, which uses your own sign-in; Craft Anything never sees or handles your account. Your use of it falls under your own agreement with Anthropic. See docs/claude-code.md for how and why. A Codex adapter exists but hasn't been verified on a real install yet. GitHub Copilot can use your installed Copilot CLI through ACP: sign in separately with copilot login. Grok Build can use your installed grok program through ACP (grok agent stdio): sign in separately with grok login. See docs/grok.md. Other agents that speak ACP (Gemini CLI, Qwen Code, opencode, goose, Hermes, Maki, Devin) can be switched to it per backend; of those, Maki and Devin have been run live (Devin authenticates with the backend's stored key — its own CLI sign-in doesn't count over ACP). Anthropic, OpenAI, OpenRouter, xAI (Grok, when XAI_API_KEY is set) and local OpenAI-compatible servers are available for questions and analysis (Settings → AI).

Built for agents

Every tool is also a CLI subcommand and an MCP tool, so an agent can study a target or run a whole rebuild without the app:

craft-anything-cli commands                                   # every tool, by toolset
craft-anything-cli mcp                                        # serve them to any MCP client
craft-anything-cli rebuild https://example.com "Recreate this website"

Results are evidence records with their confidence, coverage and limitations; big ones come back as a summary first and are paged with core_evidence_browse. craft-anything-cli setup connects Craft Anything to coding-agent apps.

Under the hood

A pure-Rust reverse-engineering engine with 320 tools (300 in the engine, the rest from the AI and setup layers) for native programs, .NET, Java, Android, Apple, Electron/JavaScript, websites, firmware, packet captures, databases and game files. Its own decoders, disassembler and decompiler work without any outside program; Deep mode uses them all, and Ghidra when it's installed. It powers the desktop app (egui), the CLI and the MCP server, and parts of it run in the browser as WebAssembly. The full list is in docs/tools.md.

Get started

Requires Rust 1.97 or newer (a dependency needs it; rustup update). On Debian or Ubuntu, the desktop app also needs:

sudo apt-get install build-essential libxkbcommon-dev libxkbcommon-x11-0 libwayland-dev libx11-dev libxrandr-dev libxi-dev libgl1-mesa-dev libgtk-3-dev

Then:

git clone https://github.com/storytold/craft-anything && cd craft-anything
cargo run --release -p craft-anything                # the desktop app
cargo install --path apps/craft-anything-cli         # the CLI, as `craft-anything-cli`
craft-anything-cli doctor                            # checks the install, coding agents and engines

Building needs a coding agent signed in on your computer (see AI); doctor says what's missing. Rebuild from the command line (questions are asked in the terminal):

craft-anything-cli rebuild https://example.com "Recreate this website"
craft-anything-cli rebuild - "A snake game in Rust" --rounds 1
craft-anything-cli rebuild https://example.com "Make the header blue" --continue-in "<project folder>"
craft-anything-cli rebuild - "Add a contact form" --project-folder "<your folder>" --existing edit

New projects go in Documents/Craft Anything (change it in Settings → General). Each project folder holds craft.json (the request, target, status and history), capture/ (what was recorded from the target), app/ (the generated project), checks/ (each comparison against the original), investigation.cany/ (evidence) and inbox/ (open questions).

A project can also start in a folder you pick (Choose a folder… under Start, or --project-folder). If it already has files, you say what they are: the app itself, which the builder edits in place, or material to start from, with the app built in app/ beside them (Settings → General can remember the answer). Settings → General also lists projects from more folders; removing one only takes it off the list.

Status

[!IMPORTANT] Status: Craft Anything is in early alpha. What works today, what is partial and what's next:

  • Works today: the desktop app (Simple and Advanced), the CLI and the MCP server; the Study → Build → Check → Ready workflow for websites, apps and games with Claude Code as the builder; website checks at three screen widths; game rebuilds in Unity, Unreal or Godot; Deep mode with Ghidra; generated pictures and 3D models (opt-in, your own fal.ai key); plugins (MCP servers, and WASM components in builds with the wasm-plugins option).
  • Partly there: building with API keys and other coding agents (built, not yet run live), behaviour checks for apps and games, a few engine tools tested only against stand-ins.
  • Released: public releases with installers for Windows, macOS, Linux and FreeBSD are published on the Releases page; they are still alpha.
  • Next: the managed tier.

docs/STATUS.md has the detail and how each part was checked, docs/tool-status.md the tool-by-tool checklist, and docs/ROADMAP.md the plan, item by item. Please file issues, or tell us what broke on Discord.

Responsible use. Use Craft Anything on software you own or are allowed to examine. It never bypasses DRM, logins or anti-cheat. Rebuilds recreate layout, style and behaviour from evidence; the agent is told not to copy logos, photos or text unless you confirm you own them or have permission.

Installing dependencies runs code. When a builder installs a project's dependencies, the commands run on your computer, and the packages can run code while they install. npm runs each package's install scripts by default, and Rust build scripts and Python source packages run their own setup code. Craft Anything asks before a command of a kind it hasn't seen in this project (npm, cargo…). Choosing "always allow" for npm lets every later npm command run without asking, so only do that for a project whose dependencies you trust. To install npm packages without their install scripts, run npm install --ignore-scripts.

Downloads

On GitHub, the latest release has every build listed below, and all releases has earlier versions and their notes. <ver> in the file names is the version number, and SHA256SUMS.txt lists a checksum for every file.

Windows

Build Installer Portable
x64 (64-bit Intel/AMD) craft-anything-<ver>-windows-x64.msi craft-anything-<ver>-windows-x64-portable.zip
arm64 (Snapdragon and other ARM PCs) craft-anything-<ver>-windows-arm64.msi craft-anything-<ver>-windows-arm64-portable.zip
x86 (32-bit) craft-anything-<ver>-windows-x86.msi craft-anything-<ver>-windows-x86-portable.zip

Installers and executables are code-signed. The portable zip keeps its settings next to the app.

macOS

Build File Notes
App, universal (Apple silicon + Intel) craft-anything-<ver>-macos-universal.dmg Signed and notarized
Command-line tool, universal craft-anything-cli-<ver>-macos-universal.zip Signed and notarized; see below if macOS blocks it

Versions after 0.2.0 include the command-line tool in the app, so builds don't need the separate zip. You only need it to use the command line without the app.

A browser download of the zip can stop with "Apple could not verify craft-anything-cli" (a lone program can't carry its notarization with it, so macOS has to look it up online). A download from the terminal isn't checked this way, so use this instead:

ver=0.2.0   # change this to the version you want
curl -fLO "https://github.com/storytold/craft-anything/releases/download/v$ver/craft-anything-cli-$ver-macos-universal.zip"
ditto -x -k "craft-anything-cli-$ver-macos-universal.zip" .
mkdir -p ~/.local/bin
mv "craft-anything-cli-$ver-macos-universal/craft-anything-cli" ~/.local/bin/
~/.local/bin/craft-anything-cli --version

To run it as just craft-anything-cli, add ~/.local/bin to your PATH.

If you already have the blocked copy, press Done (not Move to Bin), then run xattr -d com.apple.quarantine <path to craft-anything-cli>, or allow it in System Settings → Privacy & Security → Open Anyway.

Checking that a Mac download is signed and notarized

Each Mac release is signed with a Developer ID certificate and notarized by Apple. To check a download yourself, run these in Terminal (replace <ver> with the version and the paths with yours):

# The disk image: "accepted" and "source=Notarized Developer ID" mean it passed
spctl --assess --type open --context context:primary-signature -v "craft-anything-<ver>-macos-universal.dmg"
# The notarization ticket is attached: prints "The validate action worked!"
xcrun stapler validate "craft-anything-<ver>-macos-universal.dmg"

# The app, after you open the disk image: the signature must verify
codesign --verify --deep --strict --verbose=2 "/Volumes/<disk image name>/Craft Anything.app"
spctl --assess --type execute --verbose "/Volumes/<disk image name>/Craft Anything.app"

# The command-line tool: a bare program can't carry a ticket, so macOS checks it online
codesign --verify --strict --verbose=2 ~/.local/bin/craft-anything-cli
codesign -dv --verbose=4 ~/.local/bin/craft-anything-cli 2>&1 | grep Authority

The Authority lines should name a "Developer ID Application" certificate. If a check fails, don't run the file; report it with the output and the release tag.

Linux

Format x86_64 aarch64 (ARM64) Notes
AppImage craft-anything-<ver>-linux-x86_64.AppImage craft-anything-<ver>-linux-aarch64.AppImage Runs anywhere; updates itself with AppImageUpdate (.zsync files)
Flatpak craft-anything-<ver>-linux-x86_64.flatpak craft-anything-<ver>-linux-aarch64.flatpak Sandboxed, so it can't start a browser on your computer, which studying websites needs (use another package for that); flatpak install --user <file>
Debian/Ubuntu craft-anything-<ver>-linux-x86_64.deb craft-anything-<ver>-linux-aarch64.deb
Fedora/RHEL/openSUSE craft-anything-<ver>-linux-x86_64.rpm craft-anything-<ver>-linux-aarch64.rpm
Tarball craft-anything-<ver>-linux-x86_64.tar.gz craft-anything-<ver>-linux-aarch64.tar.gz Unpack anywhere

RISC-V (riscv64): craft-anything-<ver>-linux-riscv64.tar.gz, a tarball only.

The AppImage carries the CLI too: run <AppImage> --cli <command> (for example <AppImage> --cli mcp for an MCP client), or make a link to the AppImage named craft-anything-cli and run that.

FreeBSD

Build File
x86_64 craft-anything-<ver>-freebsd-x86_64.tar.gz

Web (WebAssembly)

Build File Notes
Browser viewer craft-anything-web-<ver>.zip Says what a file is, in the browser (the file never leaves it); host the folder on any static web server (packaging/web/README.md)

Join the ArtCraft community on Discord

Come make things with us

Our Discord is where artists of every kind hang out: people who paint, shoot, draw, cut film, set type, and people still figuring out what they like to make. Share what you're working on, ask for help, tell us what's broken, or tell us what you wish these tools could do. Whatever your medium and however long you've been at it, you're welcome here.

discord.gg/artcraft · getartcraft.com · The Crafting Apps · Craft Anything


The Craft App Suite

App What it's for Code Learn more
PhotoCraft Image editing: layers, masks, type and real PSD files GitHub Website
VectorCraft Vector illustration GitHub Website
FilmCraft Video editing, color and sound GitHub Website
LightCraft Photo library and raw development GitHub Website
PdfCraft Reading, organizing and protecting PDFs GitHub Website
EffectCraft Motion graphics and visual effects GitHub Website
DesignCraft Page layout and publishing GitHub Website
FigCraft Interface design and prototyping GitHub Website
WordCraft Word processing and documents GitHub Website
SoundCraft Audio recording and editing GitHub Website
DeckCraft Presentations and slide decks GitHub Website
CADCraft Computer-aided design GitHub Website
GridCraft Spreadsheets and data GitHub Website
TextureCraft 3D texture painting GitHub Website
MaterialCraft Node-based procedural materials GitHub Website
Craft Anything See how any software works, then build your own GitHub Website
SolidCraft Parametric 3D CAD by Tangency Labs (community app) GitHub

License and credits

Craft Anything is dual-licensed under MIT or Apache-2.0, at your option. Copyright (c) 2026 ArtCraft Team and the Craft Anything contributors (CONTRIBUTORS.md). Required notices are in NOTICE.

Bundled fonts, icons, images and other assets keep their own open licenses; each one is listed with its author, source and license in ATTRIBUTION.md.

The screenshots show sample projects made for them: example.com, a snake game and a small calculator program.

The ArtCraft name, wordmark and logos in docs/brand/ are trademarks of the ArtCraft Team and are not covered by this license. They may be used only unmodified, and only as part of this repository and Craft Anything, under docs/brand/LICENSE-brand.txt. Forks and modified versions must remove them.

ArtCraft
Made by the ArtCraft team and community.

craft-anything (storytold/craft-anything)

正在搜索数据库…

这是什么?Craft Anything 借助真实的检查工具,剖析任何网站、应用或游戏的实际工作方式,然后让 AI 编程代理用你选择的语言或框架构建一个新版本,并将重建结果与原版进行对比,不断优化直至完全一致。
这是桌面应用、命令行工具,还是两者都是?三种形式都有:一个用 egui 构建的桌面应用、一个命令行工具和一个 MCP 服务器,三者都由同一个纯 Rust 引擎驱动,共提供 314 个工具;其中部分功能还能以 WebAssembly 查看器的形式在浏览器中运行。
我怎样才能把它运行起来?你可以从 GitHub Releases 下载适用于 Windows、macOS、Linux 或 FreeBSD 的预编译安装包,也可以从源代码构建,这需要 Rust 1.97 或更新版本(若要在 Debian/Ubuntu 上使用桌面应用,还需要额外安装一些软件包)。
构建项目一定需要 Claude Code 吗?需要。构建时必须在你的电脑上登录一个编程代理;Claude Code 是首个支持的代理,它会运行你自己未经修改的 claude 程序,并使用你自己的 Anthropic 账号登录。已有 Codex 适配器,但尚未经过验证。
我能放心用它做真实项目吗?还不行,它目前处于早期 alpha 阶段。使用 API 密钥及其他编程代理进行构建的功能已经实现,但尚未进行实际运行测试;针对应用和游戏的行为检查只完成了一部分;部分引擎工具仅在替代组件上测试过。
它会读取原软件的代码来进行克隆吗?默认情况下,它以 Clean room 模式运行,不读取原软件内部的任何内容(没有代码、文件或页面源码),只使用可见的信息,例如截图和渲染后的文字。能够读取实际代码和文件的 Deep 模式需要主动开启,仅供你个人私用。
它能重建游戏,而不只是网站和应用吗?可以,目前已支持用 Unity、Unreal 或 Godot 重建游戏,并会用游戏自带的自检程序进行验证。
用它处理我不拥有的软件合法吗?Craft Anything 只面向你拥有或已获得许可检查的软件;它从不绕过 DRM、登录验证或反作弊机制,并且会要求代理在未经你许可的情况下,不得复制徽标、照片或文字。
ArtCraft 是什么?ArtCraft 是 Craft Anything 背后的团队和 Discord 社区,同时也开发了 PhotoCraft、VectorCraft、FilmCraft 等一整套更广泛的创意应用。
不用 AI 也能使用这个引擎吗?可以,它的全部 314 个工具都同时是命令行命令和 MCP 工具,因此任何代理(或你自己)都能在检查本身不需要 AI 的情况下,对目标进行检查。
作者
storytold
大小
19.7 MB
星标
35.7K
时长
18天
提交 · 90 天