Aura CLI

Conversational command-line interface for Aura AI.

Installation

npm install -g @aura/aura-cli

Usage

Start the CLI:

aura

This opens a REPL-style interface for continuous conversation with the Aura AI backend.

Commands

General Commands

| Command | Description | |---------|-------------| | /help | Show available commands | | /exit | Exit the CLI (also: /quit, /q) | | /clear | Clear conversation history | | /model [name] | Show or set current model | | /config | Show current configuration | | /reset | Reset configuration to defaults |

Authentication Commands

| Command | Description | |---------|-------------| | /login | Login with Strapi credentials | | /register | Register a new account | | /logout | Logout and clear credentials | | /whoami | Show current user information |

Figma Integration Commands

| Command | Description | |---------|-------------| | /figma connect | Connect to Figma MCP server | | /figma disconnect | Disconnect from Figma MCP | | /figma status | Show Figma MCP connection status | | /figma file <key> | Get Figma file information | | /figma components <key> | List components in Figma file |

Quick Start

1. Start the CLI

aura

2. Login (Optional)

To access user-specific features and Figma-connected files:

aura> /login
Email: [email protected]
Password: ********
✓ Logged in as [email protected]

3. Connect to Figma (Optional)

To fetch Figma design data during conversations:

aura> /figma connect
Connecting to Figma MCP server...
✓ Connected to Figma MCP

aura> /figma file abc123xyz
Figma File

Name:       Design System
Key:        abc123xyz
Modified:   2025-02-02T10:30:00Z
Components: 45
Styles:     12
Variables:  8
Frames:     5

4. Start Conversing

aura> create a React button component following the design system

[Orchestrator plans execution...]
[Generates component code...]
[Validates against design rules...]

Configuration

Configuration is stored in ~/.config/aura-cli/config.json.

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | AURA_API_URL | Backend API URL | http://localhost:8000 | | AURA_STRAPI_URL | Strapi CMS URL | http://localhost:1337 | | AURA_MODEL | Default model | deepseek | | AURA_DEBUG | Enable debug logging | false |

Authentication

Aura CLI supports authentication with your Strapi account. This enables:

• Access to user-specific design context
• Viewing Figma-connected files stored in your account
• Credit tracking and subscription management
• Personalized orchestration history

Authentication data (JWT token, email) is stored securely in ~/.config/aura-cli/config.json.

Figma Integration

Aura CLI integrates with Figma MCP to fetch design data during orchestration. This allows the AI to:

• Access your Figma files and components
• Reference design tokens and styles
• Validate generated code against design specs
• Provide design-aware code generation

Aura CLI connects to the Figma desktop MCP server at:

http://127.0.0.1:3845/mcp

Make sure the desktop MCP server is enabled in Figma (Dev Mode → Inspect → MCP server → Enable).

Development

# Install dependencies
npm install

# Build
npm run build

# Run locally
npm start

# Watch mode
npm run dev

# Link for global testing
npm link

Requirements

• Node.js >= 18.0.0
• Aura API backend running at configured URL (default: http://localhost:8000)
• Strapi CMS for authentication (default: http://localhost:1337)
• (Optional) Figma desktop MCP server enabled in the Figma app

License

MIT