Installation

Install the Asena CLI globally to access the asena command from anywhere on your system.

Prerequisites

Required:

• Bun runtime v1.2.8 or higher

Verify Bun installation:

bun --version

If Bun is not installed, install it:

# macOS, Linux, and WSL
curl -fsSL https://bun.sh/install | bash

# Windows (PowerShell)
powershell -c "irm bun.sh/install.ps1 | iex"

Install Asena CLI

Install globally using Bun:

bun install -g @asenajs/asena-cli

Verify Installation

Check that the CLI is installed correctly:

asena --version

You should see the version number (e.g., 0.2.0).

View available commands:

asena --help

Update Asena CLI

To update to the latest version:

bun install -g @asenajs/asena-cli@latest

Uninstall

To remove the CLI:

bun remove -g @asenajs/asena-cli

Troubleshooting

Command Not Found

If you see asena: command not found, make sure Bun's global bin directory is in your PATH:

Check your PATH:

echo $PATH

Add Bun's bin directory to your PATH (if needed):

# For bash
echo 'export PATH="$HOME/.bun/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# For zsh
echo 'export PATH="$HOME/.bun/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Permission Errors

If you encounter permission errors during installation:

# On Linux/macOS, you may need sudo
sudo bun install -g @asenajs/asena-cli

Version Mismatch

If you have an old version installed, force reinstall:

bun remove -g @asenajs/asena-cli
bun install -g @asenajs/asena-cli

Next Steps

Now that the CLI is installed:

• Create your first project
• Learn CLI commands
• Configure your project

---

Related Documentation:

• CLI Overview
• CLI Commands
• Get Started Guide