README.md

# magdalena
[![builds.sr.ht status](https://builds.sr.ht/~mtmn/magdalena.svg)](https://builds.sr.ht/~mtmn/magdalena?)

A command-line tool for interactive shell navigation and history.

## Features

- Interactive shell navigation
- Fuzzy finding integration
- Memcached integration
- Grep integration

## Dependencies

- Zig 0.16.0
- ripgrep
- fzf
- bat
- fd
- memcached (optional)

## Building

To build the project, run:

```sh
zig build -Doptimize=ReleaseSafe
```

## Usage

```
magdalena recent-dirs
magdalena recent-files
magdalena favorites
magdalena goto-dir
magdalena goto-file
magdalena log-dir <path>
magdalena log-file <path> [type] [action]
magdalena search <query>
magdalena look-file [--depth <n>]
magdalena look-dir [--depth <n>]
magdalena grep
```

### Options

- `-c`, `--clean`: Perform cleanup
- `-h`, `--help`: Show this help

### Example

```sh
# Run magdalena
./zig-out/bin/magdalena

# Show recent directories
./zig-out/bin/magdalena recent-dirs

# Search history
./zig-out/bin/magdalena search "myquery"

# Explore directory with depth 3
./zig-out/bin/magdalena look-dir --depth 3
```