Craftian

Returns the status of an app: its metadata (name, about, kind, org, dates, remixable, restricted, custom roles), the deployed commit, whether the source changed since that deploy and which paths, the site files served, the compiled backend modules and the source file paths.

Returns a summary of one project: its name, its live URL and whether anything is published there, whether it is restricted, its git remote and editor URL, its branches and tags, and how many source files and bytes it holds. Read-only, and it reads no file contents. published is false until the project is deployed (use deploy_app), even when it has source files. initialized is false for a project whose git repository has no commit yet. For the list of files use list_files; for recent changes use git_log; for errors and runtime state use get_app_status.

Returns the data model of a deployed app: its entities with their fields, the number of records per collection, and the SQL tables.

Get additional platform documentation. Available topics: readme (platform overview, structure, and the cross-cutting rules), website (START HERE for any GUI work: the hand-written page in plain HTML + JS under website/, how it reads and writes data and handles login through @craftian/sdk, and adding a data model to an existing page), frontend (ONLY when the user explicitly asks for React: building custom React UI, the @built-in/ui component catalog, patterns, games, and TypeScript types), backend (custom server-side logic: routes, hooks, scheduler, auth, mail, and the complete db API reference). Read "website" before building or changing the page users see (plain HTML + JS, the default), "backend" for server logic + the complete db API reference, "readme" for a platform overview, and "frontend" only when the user explicitly asks for a React app.

Returns one record of a collection of a deployed app, by ID, as the current user.

Returns a project's git commit log, newest first. Each commit carries its oid, message, author (name and email), timestamp (ms since epoch), parents, and the NAMES of the files it changed, each with a status. File names only: no file contents and no diffs are returned (use read_files for the current content of a file). Statuses: added (the file did not exist before the commit), modified (it existed and its content changed), deleted (the commit removed it). A commit's file list is relative to its first parent, so the first commit of a project lists every file as added and a merge commit shows only what differs from its first parent. limit sets how many commits to return (default 20, maximum 100); truncated is true when older commits exist beyond the returned window. A commit's file list is capped at 200 entries, and filesTruncated is true on a commit whose list was capped. A project with no commits yet returns an empty list. Use this to see what changed recently before modifying a project.

Lists all projects (apps and websites are the same thing) owned by the authenticated user. Returns each one's name, id and editor URL (the project opened in the web IDE). Use this to find an existing project before changing it, instead of creating a new one. Use the returned app IDs with other tools (update_app, list_files, write_files, etc.) to manage specific apps.

Lists all files in a project, organized by category: backend (custom server logic), frontend (React UI, only in projects that use React), generated (auto-generated files, read-only), website (the hand-written page and its assets, served as-is; the default place for GUI work), compiled (website/compiled/ — generated from src/frontend/ on every deploy, read-only, writes are refused), and other (top-level configs, anything outside src/). Use this to see what files exist before creating or modifying them.

Lists the records of one collection of a deployed app, as the current user. Returns the records and the total count.

Applies targeted text replacements to one or more existing files (the page under website/, or code under src/). This is the normal way to change an existing page. Each patch specifies an exact old_string to find and a new_string to replace it with. The old_string must appear exactly once in the file (for safety). Use read_files first to see current content. For full file rewrites, use write_files instead.

Reads the contents of one or more files from a project. Can read the page and its assets (website/), custom code (src/backend/, src/frontend/) and auto-generated files (src/generated/, read-only). Use this to inspect existing code before making changes with write_files or patch_files.

Searches across all source files in an app for a text pattern. Returns matching lines with file paths and line numbers. Useful for finding where a function, component, or variable is defined or used. Supports regex patterns. Optionally filter by file path prefix (e.g. "src/frontend/").

Updates an existing app. All updates are partial (merge-style) — only specify what you want to change. You do NOT need to resend the full model. Only include new or modified entities, and within each entity, only new or modified fields. Only the properties you specify will be updated; omitted properties remain unchanged. To remove entities, use deleteEntities with an array of entity names. To add or modify entities, include them in project.entities — existing entities matched by name are updated, new names create new entities. Fields within entities follow the same partial logic: include only what is new or changed. Set deploy=true to redeploy after updating. Requires app ownership. This is the ONLY way to add or change the data model: a project is created with no entities, and they are added here when the user needs to store data. Note: this only updates the data model (tables and their API). It does NOT change the page users see: a hand-written website/index.html stays as it is, so after adding entities connect the page to them with the file tools (read get_docs("website") first), then deploy. Data is private by default (signed-out visitors are refused, signed-in users see their own records), so the page then needs a sign-in step, or allowAnonymousCRUD on an entity that is meant to be public. Do not rebuild the GUI in React for this unless the user explicitly asks for React.

Changes the given field values of one record of a deployed app, as the current user. Returns the ID of the record.

Creates or updates one or more files in a project. If a file exists it is overwritten; if it does not exist it is created. The change is saved to the project source and its git history. It goes live on deploy_app. Page files (website/): the hand-written GUI in plain HTML, CSS and JavaScript, served as-is. This is the DEFAULT place for GUI work. Backend files (src/backend/): TypeScript (.ts) for custom routes, hooks and scheduled tasks. Frontend files (src/frontend/): React components (.tsx). Write here ONLY when the user explicitly asked for a React app. Read get_docs("website") before page work that touches data or login, get_docs("backend") before backend code, and get_docs("frontend") before React code. Allowed extensions: .ts, .tsx, .json, .css, .scss, .html, .md, .txt, plus .js under website/ only.