Skip to main content
Glama

Write App Files

write_app_files
Destructive

Create, edit, append to, move, or delete the text files of an app you write for the user, stored on Control Plane per org and app NAME across calls and sessions; NAME is also the image and workload name. In a shell on the user's machine with a working cpln CLI (never a chat app's sandbox), prefer a directory there and cpln image build --remote --dir PATH --name NAME:TAG --org ORG, so the user keeps the code. Whole files in files, a large file in parts through appends, exact-text replacements in edits, removals in deletePaths, moves and renames (uploaded files too) in moves, at most 200 files per call. Files the user has (images, fonts, PDFs, data) never go inline: create_app_files_upload_link takes the ones that stay as they are until the next build, and content the owner changes after launch is uploaded through the app once it runs. Never include credentials or a .env with values. A Dockerfile is optional for common stacks. An app that keeps anything (content its owner changes, records, files, or sign-ins; for example a portfolio, a blog, or a shop): plan_app before the first write. Then deploy_app with the same NAME builds and runs it.

Input Schema

NameRequiredDescriptionDefault
orgNoOrganization slug.
nameYesThe app's name, e.g. "todo-app". One name for the whole app: the `name` here, the image NAME that build_image produces (//image/NAME:TAG), and the workload name.
adoptNoConfirm that Control Plane's stored copy becomes this app's source of truth although the app was built from a repository, a folder on a machine, or an image pushed outside a Control Plane build. Only after the user asked for exactly that.
editsNoExact-text replacements in stored files (read the file first).
filesNoFiles to add or replace in full.
movesNoFiles to move or rename, uploaded ones too; nothing is sent again. Onto a stored file only if deletePaths names it.
appendsNoText added at the end of files: a large file arrives in parts, the first in `files`, the rest here.
deletePathsNoFiles to remove.

Output Schema

NameRequiredDescriptionDefault
okYes
dataNoThe full result. Read this, not only the summary.
detailsNo
summaryYes
nextStepsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.