basion-start

CLI to scaffold new Basion AI agent projects.

Usage

# Interactive mode
npx basion-start-cli

# Create a named project
npx basion-start my-agent

# Use defaults (no prompts)
npx basion-start my-agent --yes

What it creates

Running basion-start creates a new directory with:

my-agent/
├── src/
│   └── agent.ts      # Main agent code
├── .env.example      # Environment template
├── .gitignore
├── package.json
├── tsconfig.json
└── README.md

Options

| Flag | Description | |------|-------------| | -y, --yes | Skip prompts, use defaults | | -h, --help | Show help | | -v, --version | Show version |

Interactive Prompts

When run without --yes, you'll be asked:

1. Project name - Directory name and package name
2. Agent name - Name for agent registration
3. Gateway URL - Basion Agent Gateway URL
4. Initialize git - Create git repository
5. Install dependencies - Run pnpm install

After Creation

cd my-agent
cp .env.example .env
# Edit .env with your API keys
pnpm dev

Requirements

• Node.js 18+
• pnpm (recommended) or npm

Related

• basion-ai-sdk - The SDK this CLI scaffolds projects for

License

MIT