agentleFS
acquiaacquia/acquia-skills-private/skills/acli/application-management/SKILL.md

application-management

Skill1 starsChanged 7 months agoMITView on GitHub

Use when listing Acquia Cloud applications, linking or unlinking a local repo to an application, opening an app in browser, checking VCS/branch deployment status, or exporting a site archive.

1 other project uses a version of this, 1 of them edited.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

Managing Applications

Use when:

  • Listing applications you have access to
  • Linking or unlinking a local repo to a Cloud application
  • Creating a new Drupal or Next.js project
  • Checking branch/tag deployment status
  • Waiting for an async task to complete
  • Exporting a full site archive

List Applications

acli api:applications:list

Returns a JSON array of all applications you have access to. Each entry includes id, uuid, name, type, status, and organization.

To display a readable table:

acli api:applications:list | python3 -c "
import json, sys
apps = json.load(sys.stdin)
for a in apps:
    print(f\"{a['id']:<10} {a['name']:<40} {a.get('type',''):<10} {a.get('status',''):<10}\")
"

Open Application in Browser

acli app:open

Aliases: acli open, acli o

Opens the selected Cloud application in your default browser.


Link and Unlink a Local Repository

Associate your local checkout with a Cloud application so commands like env:deploy can detect the app automatically:

cd /path/to/project
acli app:link

To remove the association:

acli app:unlink

Tail Application Logs

Stream live logs from a Cloud environment:

acli app:log:tail

Prompts for the application and environment, then tails all available log streams in real time. Useful for monitoring deployments or debugging live issues.


Check Branch and Tag Deployment Status

acli app:vcs:info

Lists all branches and tags in the application's git repository along with which environment (if any) each is currently deployed to.


Wait for an Async Task

Some Cloud operations (database copies, environment mirrors) return a notification UUID. Wait for them to complete:

acli app:task-wait <notification-uuid>

Useful in CI/CD pipelines to block until a task finishes before proceeding.


Create a New Local Project

Scaffold a new Drupal or Next.js project from an Acquia-recommended template:

# Interactive — prompts for template and directory
acli app:new:local

# Non-interactive
acli app:new:local my-project --template=acquia_drupal_recommended
acli app:new:local my-project --template=acquia_drupal_cms

Alias: acli new

Available templates:

  • acquia_drupal_recommended — Standard Acquia Drupal project
  • acquia_drupal_cms — Acquia Drupal CMS project

Migrate from Drupal 7

Generate a new Drupal 9+ project from an existing Drupal 7 application using Acquia Migrate Accelerate:

acli app:new:from:drupal7

Options: --drupal7-directory, --drupal7-uri, --stored-analysis, --recommendations, --directory

Aliases: acli ama, acli from:d7


Export a Site Archive

Export an application's code, files, and database as a single archive file:

acli archive:export /path/to/destination/

Options:

# Exclude public files
acli archive:export /path/to/destination/ --no-files

# Exclude database
acli archive:export /path/to/destination/ --no-database

# Use a specific source directory
acli archive:export /path/to/destination/ --dir=/path/to/drupal

Best Practices

  1. Link your repo — Run acli app:link in every project checkout so app-aware commands work without extra flags.
  2. Check VCS status before deploying — Use acli app:vcs:info to confirm the right branch is ready.
  3. Use app:task-wait in CI — Ensures async Cloud operations complete before the next pipeline step runs.

Related Topics

  • Environment Management — List environments, deploy, create CDEs
  • Pull & Push — Sync code, database, and files
  • Remote Access — SSH, Drush, and log tailing
  • SSH Key Management — Secure access setup

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.