Free your brain from npm script chaos–Akio helps you search, understand, and run your project scripts fast.

I recommend using akio directly from the npm registery to get familiar with its monorepo functionality. See Documenting Scripts below to populate your scriptDescriptions.

# using this DevX tool is as easy as running:
npx @abullard/akio

Akio can target a package with the @pkg syntax:

# find commands from the ui package
akio @ui

# to target root package.json
akio @root

Targeting requires your package.json files live at the root of your package. e.g.

• ../ui/package.json
• ../api/package.json
• ../smoke/package.json

Akio treats the first unnamed CLI argument as a search term:

# search for scripts containing the text "build":
akio build

# search the api package for scripts containing the text "test":
akio @api test

# order doesn't matter
akio coverage @ui

npm install -g @abullard/akio

Add a scriptDescriptions section to your package.json:

{
    "scripts": {
        "dev": "vite",
        "build": "vite build",
        "test:integration": "vitest ./tests/integration/**/*.spec.ts",
    },
    "scriptDescriptions": {
        "dev": "Starts the dev server",
        "build": "Builds the project for production",
        "test:integration": "Test that the application works when all components are integrated.",
    },
}

No more guessing what test:integration does.

For the best UX, use it as an alias in your .zshrc so you can fetch with just akio:

# $(npm prefix -g) will fetch your global install location, locking the app version
alias akio="$(npm prefix -g)/bin/akio"

# if you always want the latest version, and have a stable network connection
alias akio="npx @abullard/akio"

Example in package.json:

"scripts": {
  "akio": "npx @abullard/akio"
}

• Akio works best with pnpm, but supports npm and yarn. Please setup pnpm-workspace.yml for proper Target a Package functionality.
• akio infers which package manager to use based on your lockfile:

• Dev teams with lots of internal scripts
• Open source projects that skimp on docs
• Onboarding new teammates
• Old projects you forgot how to run

• Auto deploy GHA & README badges
• JSONC-style inline comments

MIT