manage-app

Manages remotes, sync, build, deploy, logs, and CI/CD for Twenty apps.

56.0k|8.9k|Updated Dec 1, 2022
One-click install
npx skills add https://github.com/twentyhq/twenty --skill manage-app
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: manage-app
Source: https://github.com/twentyhq/twenty/tree/main/packages/twenty-codex-plugin/skills/manage-app
Command: npx skills add https://github.com/twentyhq/twenty --skill manage-app

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Operating an existing Twenty app involves many moving parts: remotes, sync, builds, deploys, logs, and CI/CD. This Skill guides you through managing and troubleshooting the full operational lifecycle of a Twenty app, from syncing changes to a server to deploying to production and diagnosing failures.

Core Features & Use Cases

  • Remote Management: Add, list, and switch Twenty server remotes, including local and production targets with stored credentials.
  • Sync, Build & Deploy: Apply app changes with bounded sync, build packages, publish privately or to npm, and install or uninstall apps on target workspaces.
  • Troubleshooting & Logs: Diagnose failures across remote, sync, build, deploy, and runtime layers using verbose apply output, function logs, and manual function execution.
  • Use Case: Your deploy to production failed. Use this Skill to identify the failing layer, run yarn twenty apply --verbose, inspect function logs, and redeploy with a bumped semver version.

Quick Start

Ask the assistant to sync your Twenty app changes to the active remote and check the logs for a failing logic function.

Frequently Asked Questions about manage-app

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a Twenty app to production?

Build the app with yarn twenty dev:build, then publish privately with yarn twenty app:publish --private --remote production and install it with yarn twenty app:install. Ensure package.json has a strictly higher semver version than the currently deployed version.

How do I sync Twenty app changes to a server?

Run yarn twenty apply to perform a bounded sync of app changes to the active remote. Avoid bare yarn twenty dev watch mode, and confirm the correct remote is active with yarn twenty remote:list before syncing.

How do I add or switch Twenty remotes?

Use yarn twenty remote:add for interactive setup, yarn twenty remote:add --local for a local server, or yarn twenty remote:add --url <url> --api-key <key> --as <name> non-interactively. Switch the active remote with yarn twenty remote:use <name>.

Why did my Twenty app deploy or sync fail?

First identify the failing layer: remote/auth, sync, build, deploy, runtime, or CI/CD. Run yarn twenty apply --verbose for a bounded failure, check remote configuration with yarn twenty remote:list, and verify the package version is higher than the deployed one.

How do I debug a Twenty logic function at runtime?

Inspect execution logs with yarn twenty dev:function:logs, optionally filtered by function name. To reproduce behavior without its trigger, run the function manually with yarn twenty dev:function:exec -n <function-name> -p '<json-payload>'.

When should I not use the manage-app skill?

Do not use it to scaffold a new app (use create-app), modify app entities like objects or logic functions (use develop-app), prepare marketplace listings (use publish-app), or query CRM records (use use-twenty-mcp).