📦 Installation Guide

Install Phoenix and bootstrap your project with core meta-skills.

🎯 What You'll Get

phoenix init installs 5 core meta-skills into your project:

Skill Purpose
git-commit Generate semantic commit messages
list-skills Browse available skills from configured repositories
add-skills Download and install skills from remote repositories
list-agents Browse available agent commands
add-agents Download and install agent commands

It also places nightlife.yaml in your project root — the configuration file that tells the meta-skills where to find skill and agent catalogs.

⚙️ What You Need

Before installing, make sure you have:

Requirement Description
Operating System Linux, macOS, or Windows (PowerShell supported)
AI Assistant Any supported agent
Package Manager uv
Python Version 3.11 or higher
Version Control Git

🚀 Installation Options

Option 1: Create a New Project

The easiest way to start:

uvx --from git+https://github.com/dauquangthanh/vinh-phoenix.git phoenix init <PROJECT_NAME>

Option 2: Initialize in Current Directory

Already have a project folder?

# Method 1: Using dot notation
uvx --from git+https://github.com/dauquangthanh/vinh-phoenix.git phoenix init .

# Method 2: Using --here flag
uvx --from git+https://github.com/dauquangthanh/vinh-phoenix.git phoenix init --here

🤖 Choose Your AI Agent

Specify which AI assistant to use:

# Claude Code
uvx --from git+https://github.com/dauquangthanh/vinh-phoenix.git phoenix init <project_name> --ai claude

# Gemini CLI
uvx --from git+https://github.com/dauquangthanh/vinh-phoenix.git phoenix init <project_name> --ai gemini

# GitHub Copilot
uvx --from git+https://github.com/dauquangthanh/vinh-phoenix.git phoenix init <project_name> --ai copilot

# Multiple agents at once
uvx --from git+https://github.com/dauquangthanh/vinh-phoenix.git phoenix init <project_name> --ai claude,copilot,gemini

⚡ Skip Tool Checks (Optional)

Want to set up without checking if AI tools are installed?

uvx --from git+https://github.com/dauquangthanh/vinh-phoenix.git phoenix init <project_name> --ai claude --ignore-agent-tools

Use this when: You're setting up on a different machine or want to configure tools later.

✅ Verify Installation

After setup, verify the core meta-skills are in place:

# For Claude Code
ls .claude/skills/

# For GitHub Copilot
ls .github/skills/

# For Gemini CLI
ls .gemini/extensions/

You should see 5 skill directories: git-commit, list-skills, add-skills, list-agents, add-agents.

Also check that nightlife.yaml exists in your project root:

cat nightlife.yaml

➕ Adding More Skills

Once initialized, use your AI assistant to extend your project:

"List available skills"
"Install the requirements-specification and coding skills"
"Show what agent commands are available"

The list-skills and add-skills meta-skills handle fetching from the configured repositories in nightlife.yaml.

🛠️ Troubleshooting

Git Authentication Issues on Linux

Having trouble with Git authentication? Install Git Credential Manager:

#!/usr/bin/env bash
set -e

echo "⬇️ Downloading Git Credential Manager v2.6.1..."
wget https://github.com/git-ecosystem/git-credential-manager/releases/download/v2.6.1/gcm-linux_amd64.2.6.1.deb

echo "📦 Installing..."
sudo dpkg -i gcm-linux_amd64.2.6.1.deb

echo "⚙️ Configuring Git..."
git config --global credential.helper manager

echo "🧹 Cleaning up..."
rm gcm-linux_amd64.2.6.1.deb

echo "✅ Done! Git Credential Manager is ready."

API Rate Limits or Auth Errors

When using list-skills or add-skills, set the appropriate token for your repository host:

# GitHub
export GH_TOKEN=ghp_your_token_here

# Azure DevOps
export AZURE_DEVOPS_PAT=your_pat_here

Need More Help?

Edit this page