import-p10k-theme — Powerlevel10k Theme Importer¶

import-p10k-theme [OPTIONS] [THEME]
```bash

## Description

Interactive tool for selecting and installing Powerlevel10k theme
configurations. Copies a preset theme configuration to `~/.p10k.zsh`.

For full customization, use `p10k configure` instead.

## Options

| Option             | Description                                    |
| ------------------ | ---------------------------------------------- |
| `-l`, `--list`     | List available themes with descriptions        |
| `-p`, `--preview`  | Preview a theme's key settings before install  |
| `-b`, `--backup`   | Backup existing ~/.p10k.zsh before overwriting |
| `-f`, `--force`    | Overwrite without confirmation                 |
| `-n`, `--dry-run`  | Show what would be done without making changes |
| `-h`, `--help`     | Show help message                              |

## Available Themes

| Theme          | Description                                       | Size |
| -------------- | ------------------------------------------------- | ---- |
| `classic`      | Traditional powerline look with angled separators | 92K  |
| `lean`         | Minimalist single-line prompt, clean and fast     | 88K  |
| `lean-8colors` | Lean variant for terminals with limited colors    | 88K  |
| `rainbow`      | Colorful multi-segment prompt with gradients      | 96K  |
| `pure`         | Pure-style minimal prompt (sindresorhus/pure)     | 12K  |
| `robbyrussell` | oh-my-zsh robbyrussell theme lookalike            | 8K   |

## Examples

```bash
# Interactive selection menu
import-p10k-theme

# List all themes
import-p10k-theme --list

# Preview rainbow theme settings
import-p10k-theme --preview rainbow

# Install classic theme
import-p10k-theme classic

# Install with backup of existing config
import-p10k-theme -b rainbow

# Dry-run to see what would happen
import-p10k-theme -n lean

# Force overwrite without confirmation
import-p10k-theme -f pure
```bash

## Files

| Path                                              | Purpose                           |
| ------------------------------------------------- | --------------------------------- |
| `~/.p10k.zsh`                                     | Installed theme configuration     |
| `/usr/share/zsh-theme-powerlevel10k/config/`      | System theme presets (Arch/etc)   |
| `~/.powerlevel10k/config/`                        | User-installed p10k presets       |

## Post-Install

After installing a theme:

```bash
# Apply immediately
source ~/.p10k.zsh

# Or restart shell
exec zsh
```bash

## Customizing After Install

Edit `~/.p10k.zsh` to customize:

```zsh
# Change prompt elements
typeset -g POWERLEVEL9K_LEFT_PROMPT_ELEMENTS=(dir vcs newline prompt_char)
typeset -g POWERLEVEL9K_RIGHT_PROMPT_ELEMENTS=(status time)

# Change colors
typeset -g POWERLEVEL9K_DIR_FOREGROUND=31
typeset -g POWERLEVEL9K_VCS_CLEAN_FOREGROUND=76

# Enable transient prompt
typeset -g POWERLEVEL9K_TRANSIENT_PROMPT=always
```bash

## See Also

- [`docs/external/powerlevel10k.md`](../external/powerlevel10k.md) — Full p10k documentation
- `p10k configure` — Full interactive configuration wizard
- [`import-ohmyzsh-plugins`](import-ohmyzsh-plugins.md) — OMZ plugin importer