Using cli outside of projects should produce a helpful error message

Open Beginner friendly
#817 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
65/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Quiet
Tech stack
javascript
Domain
cli

Research direction

Start by reproducing aio rt action ls outside an App Builder Project directory and trace the CLI path that currently reports the missing AUTH key. Done means commands requiring a project or authentication show a friendly message identifying the missing project context and explaining how to fix it.

Written by the indexing model from the issue text.

Description

bug
Expected Behavior

If a dev uses a command that requires a project/auth, outside of a project dir they should see an error message stating that they are not in an App Builder Project dir.
Messaging should be friendly and indicate how to fix the problem (this is an easy fix)

Actual Behavior

➜ aio-lib-runtime git:(master) aio rt action ls
› Error: failed to list the actions: An AUTH key must be specified
› specify --verbose flag for more information

Reproduce Scenario (including but not limited to)
Steps to Reproduce

navigate away from an app builder project and try something ...
See Actual Behavior above ^^

Environment Info
  System:
    OS: macOS 26.4.1
    CPU: (16) arm64 Apple M4 Max
    Memory: 3.89 GB / 48.00 GB
    Shell: 5.9 - /bin/zsh
  Binaries:
    Node: 22.21.1 - /Users/jessem/.nvm/versions/node/v22.21.1/bin/node
    Yarn: Not Found
    npm: 11.12.1 - /Users/jessem/.nvm/versions/node/v22.21.1/bin/npm
  Virtualization:
    Docker: 28.5.1 - /usr/local/bin/docker
  npmGlobalPackages:
    @adobe/aio-cli: 11.0.2
Sample Code that illustrates the problem
Logs taken while reproducing problem
Dominant language
JavaScript
Stars
95
Forks
45
Avg merge
29m
Merged PRs (30d)
4

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from adobe/aio-cli

All issues in adobe/aio-cli

Similar issues

More JavaScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.