Metadata-Version: 2.4
Name: pinkyclawd
Version: 0.2.0
Summary: Production-grade TUI for AI-assisted development with RLM context management
Project-URL: Homepage, https://github.com/tekcin/PinkyClawd
Project-URL: Documentation, https://github.com/tekcin/PinkyClawd#readme
Project-URL: Repository, https://github.com/tekcin/PinkyClawd
Project-URL: Issues, https://github.com/tekcin/PinkyClawd/issues
Author-email: Michael Thornton <tekcin@yahoo.com>
License: MIT
License-File: LICENSE
Keywords: ai,anthropic,claude,coding,development,gpt,llm,openai,rlm,terminal,tui
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development
Classifier: Topic :: Terminals
Requires-Python: >=3.11
Requires-Dist: anthropic>=0.25.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: openai>=1.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: textual>=0.50.0
Requires-Dist: tiktoken>=0.6.0
Provides-Extra: all
Requires-Dist: mypy>=1.8.0; extra == 'all'
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'all'
Requires-Dist: pytest>=8.0.0; extra == 'all'
Requires-Dist: ruff>=0.3.0; extra == 'all'
Provides-Extra: dev
Requires-Dist: mypy>=1.8.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.3.0; extra == 'dev'
Description-Content-Type: text/markdown

# PinkyClawd

```
╭──────────────────────────────────────────────────────────╮
│                                                          │
│   ██████╗ ██╗███╗   ██╗██╗  ██╗██╗   ██╗                │
│   ██╔══██╗██║████╗  ██║██║ ██╔╝╚██╗ ██╔╝                │
│   ██████╔╝██║██╔██╗ ██║█████╔╝  ╚████╔╝                 │
│   ██╔═══╝ ██║██║╚██╗██║██╔═██╗   ╚██╔╝                  │
│   ██║     ██║██║ ╚████║██║  ██╗   ██║                   │
│   ╚═╝     ╚═╝╚═╝  ╚═══╝╚═╝  ╚═╝   ╚═╝                   │
│                                                          │
│   ██████╗██╗      █████╗ ██╗    ██╗██████╗              │
│   ██╔════╝██║     ██╔══██╗██║    ██║██╔══██╗            │
│   ██║     ██║     ███████║██║ █╗ ██║██║  ██║            │
│   ██║     ██║     ██╔══██║██║███╗██║██║  ██║            │
│   ╚██████╗███████╗██║  ██║╚███╔███╔╝██████╔╝            │
│    ╚═════╝╚══════╝╚═╝  ╚═╝ ╚══╝╚══╝ ╚═════╝             │
│                                                          │
│           ◢◤ AI-Powered Development ◥◣                  │
╰──────────────────────────────────────────────────────────╯
```

AI-powered development tool with TUI interface and Recursive Language Model (RLM) context management for unlimited conversation context.

## Features

- **RLM Context Management**: Automatic context archival and retrieval enables conversations beyond context window limits
- **Multi-Provider Support**: Anthropic (Claude), OpenAI (GPT-4), and more
- **Rich TUI Interface**: Full-featured terminal UI with Textual
- **14 Built-in Tools**: bash, read, write, edit, glob, grep, todo, webfetch, memory, and more
- **Session Management**: Fork, export, and manage conversation sessions
- **Slash Commands**: `/context`, `/search`, `/compact`, `/models`, `/agents`

## Installation

### via npm (recommended)

```bash
npm install -g pinkyclawd
```

### via pip

```bash
pip install pinkyclawd
```

### From source

```bash
git clone https://github.com/tekcin/PinkyClawd.git
cd PinkyClawd
pip install -e .
```

## Requirements

- Python 3.11+
- Node.js 16+ (for npm installation)

## Usage

```bash
# Start the TUI
pinkyclawd

# Start with a specific project
pinkyclawd /path/to/project

# Continue last session
pinkyclawd --continue

# Run a single command (non-interactive)
pinkyclawd run "explain this codebase"

# List available models
pinkyclawd models
```

## Configuration

Create `~/.config/pinkyclawd/pinkyclawd.json`:

```json
{
  "model": "anthropic/claude-sonnet-4",
  "theme": "pinkyclawd",
  "rlm": {
    "enabled": true,
    "threshold_ratio": 0.33,
    "auto_retrieve": true
  }
}
```

## Environment Variables

```bash
export ANTHROPIC_API_KEY=sk-ant-...
export OPENAI_API_KEY=sk-...
```

## RLM (Recursive Language Model)

RLM enables unlimited context by automatically:

1. **Tracking** token usage across the conversation
2. **Archiving** older context when threshold is reached (default: 33%)
3. **Retrieving** relevant archived context for new queries
4. **Injecting** context into the conversation seamlessly

### Manual RLM Commands

- `/context` - Show current token usage
- `/search <query>` - Search archived context
- `/compact` - Manually trigger context archival

### RLM Tools

- `memory` - Search and retrieve archived context
- `rlm_query` - Execute Python queries on archived context

## License

MIT

## Author

Michael Thornton (tekcin@yahoo.com)
