Metadata-Version: 2.4
Name: loktar-cli
Version: 0.1.0
Summary: CLI and AI agent client for LOKTAR — query 2100+ curated AI tools across 86+ tablets
Author-email: Loktar Team <info@loktar.cc>
License: MIT
Project-URL: Homepage, https://loktar.cc
Keywords: cli,ai-tools,agents,mcp,loktar
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

# LOKTAR CLI (`loktar`)

A super efficient, scriptable command-line interface and AI agent client for **LOKTAR** (https://loktar.cc).

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

## Installation

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

Or run without installing:

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

## Quick Start

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

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

### 2. Commands

```bash
# Ping service
loktar ping

# Search tools (returns concise table)
loktar search "ocr"

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

# List all tablets
loktar tablets list

# Inspect a specific tablet
loktar tablets get ocr

# Inspect tool details
loktar tools get "Chandra OCR"

# Display CLI agent guide
loktar guide

# Display full agent skill
loktar skill
```

## Options

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

## License

MIT License
