Metadata-Version: 2.4
Name: velixar-cli
Version: 0.1.0
Summary: Velixar Memory API — CLI
Author: Velixar AI
License-Expression: MIT
Project-URL: Homepage, https://velixarai.com
Project-URL: Documentation, https://docs.velixarai.com
Project-URL: Repository, https://github.com/VelixarAi/velixar-cli
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.0
Requires-Dist: rich>=13.0
Requires-Dist: requests>=2.28
Dynamic: license-file

# Velixar CLI

Memory API for AI applications — from your terminal.

## Install

```bash
pip install velixar-cli
```

## Setup

```bash
velixar auth login
# paste your API key (vlx_...)
```

Or set the environment variable:
```bash
export VELIXAR_API_KEY="vlx_your_key"
```

## Usage

```bash
# Store a memory
velixar store "User prefers dark mode" --tier 0

# Search memories
velixar search "user preferences"

# List recent memories
velixar list --limit 20

# Get a specific memory
velixar get mem_abc123

# Delete a memory
velixar delete mem_abc123

# Check API health
velixar health

# Interactive shell
velixar interactive
```

## Interactive Mode

```
$ velixar interactive
╭─ Velixar Interactive Shell ─╮
│ Commands: store search list get delete quit │
╰──────────────────────────────╯

velixar> store User likes Python and Rust
✓ Stored: mem_xyz789

velixar> search programming languages
  mem_xyz789.. (0.923) User likes Python and Rust

velixar> quit
```

## Links

- [Documentation](https://docs.velixarai.com)
- [API Reference](https://docs.velixarai.com/api-reference/introduction)
- [Dashboard](https://velixarai.com)
