Slate CLI

Slate CLI is a agentic terminal UI (TUI) that helps you code faster, work on hard software, and understand large codebases.

Get started

1. Install Slate:

npm install -g @randomlabs/slatecli

2. Navigate to your project directory and run slate.

Worktree Session Management

Slate provides powerful git worktree integration that allows you to work on multiple branches simultaneously while maintaining separate chat sessions for each context. This is particularly useful for:

• Working on feature branches while keeping main branch context separate
• Comparing implementations across different branches
• Managing multiple development streams simultaneously

Worktree Slash Commands

/worktree new [branch-name] [--create-branch]

Create a new session in a git worktree.

Examples:

/worktree new feature/new-api
/worktree new hotfix/bug-123 --create-branch
/worktree new

• If branch-name is provided, creates a worktree for that branch
• Use --create-branch flag to create a new branch if it doesn't exist
• If no branch name is provided, prompts for branch selection

/worktree select

Opens an interactive dialog to select and switch to an existing worktree session.

• Shows all available worktrees with branch names and last accessed times
• Allows quick switching between different worktree contexts
• Preserves chat history for each worktree session

/worktree remove <worktree-name>

Remove a worktree session and its associated chat history. The branch is preserved by default.

Example:

/worktree remove feature-api-worktree

/worktree exit

Exit the current worktree session and return to the main repository context.

Worktree Session Features

• Automatic Session Saving: Chat sessions are automatically saved when switching between worktrees
• Branch-Specific Context: Each worktree maintains its own chat history and context
• Interactive UI: Navigate worktrees using the built-in interface (accessible via the sessions menu)
• Git Integration: Full integration with git worktree commands and branch management
• Session Restoration: Automatically restores the last active session when returning to a worktree

Working with Worktrees

1. Create a new worktree session: Use /worktree new to create a worktree for a specific branch
2. Switch between worktrees: Use /worktree select for interactive selection or navigate via the UI
3. Maintain separate contexts: Each worktree keeps its own chat history and workspace context
4. Clean up: Use /worktree remove to delete worktrees you no longer need (branches are preserved)

Reporting Bugs

We welcome your feedback! You can report issues in two ways:

1. Use the /bug command to report issues directly within slate
2. Report issues on GitHub: https://github.com/entropy-research/slate-cli

For more information, visit randomlabs.ai