lovelace chat [options]

$ lovelace chat

🤖 Lovelace CLI v1.0.0
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Connected to: claude-sonnet-4-5
Workspace: my-project
Project: /Users/dev/my-project

Type your message or use slash commands:
  /help    Show available commands
  /context Add files to conversation
  /clear   Clear conversation history
  /exit    End session

You: How does authentication work in this codebase?

🤖 I can see you're working on a Next.js project with NextAuth.js. Let me analyze
   your authentication setup.

   Based on the code in `src/app/api/auth/[...nextauth]/route.ts`, your auth system uses:

   1. **OAuth Providers**: Google and GitHub OAuth
   2. **Session Strategy**: JWT-based sessions
   3. **Callbacks**: Custom JWT and session callbacks for user metadata

   Would you like me to explain any specific part in more detail?

You: Yes, explain the session callback

🤖 The session callback in your setup does two things:

   [Detailed explanation with code references]

You: /exit

✓ Session saved: session_abc123

$ lovelace chat

You: Help me add authentication to my app

🤖 I'd be happy to help! To give you the best guidance, let me ask a few questions:

   1. What framework are you using?
      • Next.js
      • Express.js
      • Other

   2. What type of authentication do you need?
      • Email/password
      • OAuth (Google, GitHub, etc.)
      • Passkeys
      • Multiple methods

   3. Do you have a database set up?
      • Yes (which one?)
      • Not yet

You: Next.js 14 with App Router, OAuth with Google and GitHub, using Prisma with PostgreSQL

🤖 Perfect! I'll help you implement OAuth authentication with Google and GitHub using:
   ✓ Next.js 14 App Router
   ✓ NextAuth.js v5 (Auth.js)
   ✓ Prisma with PostgreSQL

   Let's start step-by-step. First, would you like me to:
   1. Show you the complete setup
   2. Walk through it step-by-step
   3. Explain the architecture first

You: 2

🤖 Great! Here's our plan:

   **Step 1**: Install dependencies
   **Step 2**: Configure NextAuth.js
   **Step 3**: Set up OAuth providers
   **Step 4**: Create Prisma schema
   **Step 5**: Add API routes
   **Step 6**: Create login UI

   Ready to start with Step 1?

You: yes

🤖 **Step 1: Install Dependencies**

   Run these commands:
   [Installation instructions with explanations]

$ lovelace chat

You: /help

Available Commands:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Session Control:
  /exit          End chat session
  /clear         Clear conversation history
  /save          Save current session
  /resume <id>   Resume previous session

Context Management:
  /context <path>    Add file or directory to context
  /context list      Show current context
  /context clear     Clear all context

Settings:
  /model <name>      Switch AI model
  /provider <name>   Switch AI provider

You: /context src/auth/login.ts

✓ Added to context: src/auth/login.ts (234 lines)

Current context (1 file, 234 lines):
  • src/auth/login.ts

You: Review this code for security issues

🤖 I've reviewed your login.ts file. Here are the security concerns I found:

   1. **Critical**: Password hashing missing
      Line 45: Passwords stored in plain text

      Fix:
      ```typescript
      import bcrypt from 'bcrypt';
      const hashedPassword = await bcrypt.hash(password, 10);

### Resuming a Session

### Choosing a Different Provider

### Using Local Models

## Common Use Cases

### Code Review

Get AI feedback on your code changes:

### Debugging

Get help understanding errors:

### Learning

Understand new concepts or frameworks:

## Slash Commands Reference

### Session Control

| Command | Description |
|---------|-------------|
| `/exit` | End the current chat session |
| `/clear` | Clear conversation history |
| `/save` | Save current session with a name |
| `/resume <id>` | Resume a previous session |

### Context Management

| Command | Description |
|---------|-------------|
| `/context <path>` | Add file or directory to conversation context |
| `/context list` | Show all files currently in context |
| `/context clear` | Remove all files from context |

### Settings

| Command | Description |
|---------|-------------|
| `/model <name>` | Switch to a different AI model |
| `/provider <name>` | Switch to a different AI provider |
| `/help` | Show available commands |

## Environment Variables

| Variable | Description | Default |
|----------|-------------|---------|
| `LOVELACE_DEFAULT_PROVIDER` | Default AI provider | `anthropic` |
| `LOVELACE_DEFAULT_MODEL` | Default model name | Provider default |
| `ANTHROPIC_API_KEY` | Anthropic API key | - |
| `OPENAI_API_KEY` | OpenAI API key | - |
| `GOOGLE_API_KEY` | Google AI API key | - |

## Session Storage

Chat sessions are automatically saved to `~/.lovelace/sessions/` and include:

- Conversation history (all messages)
- Context files (which files were loaded)
- Model and provider used
- Timestamps for each message
- Session metadata (tags, description)

## Tips & Best Practices

### Effective Prompting

**Be specific**:

**Provide context**:

**Iterate**:

### Managing Context

**Start focused**:

**Expand as needed**:

**Clear when switching topics**:

### Session Management

**Save important sessions**:

**Resume where you left off**:

## Exit Codes

| Code | Meaning |
|------|---------|
| `0` | Chat session completed successfully |
| `1` | Error during chat session (network, authentication, etc.) |
| `2` | Invalid options provided |

## Related Commands

- **[lovelace sessions](./sessions)** - Manage and search chat history
- **[lovelace config](./config)** - Configure default provider and model
- **[lovelace workspace](./workspace)** - Manage project context

## Related Guides

- **[Interactive Chat Guide](../../guides/interactive-chat)** - Complete guide to chat features
- **[Product Requirements Example](../../examples/product-requirements)** - Using chat for PM work
- **[Hackathon Project Example](../../examples/hackathon-project)** - Building apps with chat assistance

---

**See the [Command Reference](../command-reference)** for all available commands.