# @gitlume/cli

```
   ██████╗ ██╗████████╗██╗     ██╗   ██╗███╗   ███╗███████╗
  ██╔════╝ ██║╚══██╔══╝██║     ██║   ██║████╗ ████║██╔════╝
  ██║  ███╗██║   ██║   ██║     ██║   ██║██╔████╔██║█████╗
  ██║   ██║██║   ██║   ██║     ██║   ██║██║╚██╔╝██║██╔══╝
  ╚██████╔╝██║   ██║   ███████╗╚██████╔╝██║ ╚═╝ ██║███████╗
   ╚═════╝ ╚═╝   ╚═╝   ╚══════╝ ╚═════╝ ╚═╝     ╚═╝╚══════╝
                 ✦ Illuminate Your Git History ✦
```

GitLume CLI (`gitlume`) collects your Git repository data and syncs it to [GitLume Cloud](https://gitlume.com) for powerful analytics and visualization.

## Installation

```bash
npm install -g @gitlume/cli
```

## Quick Start

1. **Get your API token** from [GitLume Dashboard](https://app.gitlume.com/settings/tokens)

2. **Set your token:**
   ```bash
   export GITLUME_TOKEN=gl_your_token_here
   ```

3. **Push your repository:**
   ```bash
   cd /path/to/your/repo
   gitlume push
   ```

4. **View analytics** at [app.gitlume.com](https://app.gitlume.com)

## Commands

| Command | Description |
|---------|-------------|
| `gitlume` | Show banner and available commands |
| `gitlume scan` | Scan repository and show summary |
| `gitlume push` | Push repository data to GitLume Cloud |
| `gitlume push -f` | Force full re-upload |
| `gitlume status` | Check sync status |

## Links

- [Website](https://gitlume.com)
- [Dashboard](https://app.gitlume.com)
- [Documentation](https://docs.gitlume.com)
- [GitHub](https://github.com/dnysus/git-lume)
