Metadata-Version: 2.4
Name: lockthard-cli
Version: 0.1.0
Summary: Super efficient CLI for LOCKTHARD AI tools directory and agents
Author-email: Lockthard Team <info@lockthard.es>
License: MIT
Project-URL: Homepage, https://lockthard.es
Keywords: cli,ai-tools,agents,mcp,lockthard
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: click>=8.1.0
Requires-Dist: requests>=2.28.0
Requires-Dist: rich>=13.0.0

# LOCKTHARD CLI (`lockthard`)

A super efficient, scriptable command-line interface and AI agent client for **LOCKTHARD** (https://lockthard.es).

Allows both human developers and autonomous AI agents (Claude Code, Antigravity, Aider, Cursor, etc.) to query, search, and inspect 61+ tablets and 1200+ AI tools with minimum token usage and zero prompt overhead.

## Installation

```bash
pip install lockthard-cli
```

Or run without installing:

```bash
pipx run lockthard-cli --help
```

## Quick Start

### 1. Authentication
Get your API key from [lockthard.es](https://lockthard.es).

- **For AI Agents & CI/CD:**
  ```bash
  export LOCKTHARD_API_KEY="lk_your_token_here"
  ```
- **Interactive Browser Login (Humans):**
  ```bash
  lockthard login
  ```
- **Manual Login:**
  ```bash
  lockthard login --token "lk_your_token_here"
  ```

### 2. Commands

```bash
# Ping service
lockthard ping

# Search tools (returns concise ASCII table)
lockthard search "ocr"

# Search tools in raw JSON (for agents / jq)
lockthard search "ocr" --json

# List all tablets
lockthard tablets list

# Inspect a specific tablet
lockthard tablets get ocr

# Inspect tool details
lockthard tools get "Chandra OCR"

# Display CLI agent guide
lockthard guide
```

## Options

- `--json` / `-j`: Output raw JSON without Rich styling.
- `--url` / `-u`: Override base server URL (default: `https://lockthard.es`).
- `--token` / `-t`: Override API token.

## License

MIT License
