Metadata-Version: 2.4
Name: kolay-cli
Version: 0.13.0a6
Summary: Command-line interface for Kolay IK (https://apidocs.kolayik.com)
Author: Tunc Ucer
License-Expression: MIT
Project-URL: Homepage, https://github.com/ezapmar/kolay-cli
Project-URL: Repository, https://github.com/ezapmar/kolay-cli
Project-URL: Issues, https://github.com/ezapmar/kolay-cli/issues
Keywords: kolay,hr,cli,kolayik,human-resources
Classifier: Development Status :: 3 - Alpha
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 :: Office/Business
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.9.0
Requires-Dist: requests>=2.31.0
Requires-Dist: rich>=13.4.2
Requires-Dist: PyYAML>=6.0
Requires-Dist: fastmcp>=3.1.0
Requires-Dist: keyring>=25.0
Requires-Dist: pyjwt>=2.8.0
Requires-Dist: Pillow>=10.0.0
Requires-Dist: rich-pixels>=3.0.0
Provides-Extra: test
Requires-Dist: pytest>=7.0; extra == "test"
Requires-Dist: pytest-mock>=3.10; extra == "test"
Requires-Dist: pytest-cov>=4.0; extra == "test"
Requires-Dist: pytest-asyncio; extra == "test"
Provides-Extra: linux
Requires-Dist: keyrings.alt>=5.0; extra == "linux"
Provides-Extra: dev
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: mypy>=1.6.0; extra == "dev"
Requires-Dist: types-requests; extra == "dev"
Requires-Dist: types-PyYAML; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Dynamic: license-file

# CLI and MCP Server for Kolay IK

```
               ███████████████████████
              ████               ████ 
             ████               ████ 
            ████               ████          ████                             ███ 
           ███                ████           ████                             ███ 
         ████                ███             ████                             ███ 
        ████               ████              ████     █████    █████████      ███     █████████ ████  ████        ████ 
       ████               ████               ████   █████    █████████████    ███    ███████████████   ████      ████ 
      ████               ████                ████  ████     ████       ████   ███   ████       █████    ███     ████ 
       ████             ██████               ████████      ████         ████  ███  ████         ████    ████    ███ 
        ████           ████████              ████████      ████         ████  ███  ████         ████     ████  ████ 
         ████         ███   ████             ████ █████    ████         ████  ███  ████         ████      ████████ 
          ████      ████     ████            ████   ████    █████     █████   ███   █████     ██████       ██████ 
           ████    ████        ███           ████     ████    ███████████     ███     ██████████████        █████ 
             ███  ████          ████                             █████                   ████               ████ 
              ███████            ████                                                                      ████ 
               ███████████████████████                                                                  ██████ 
                █████████████████████                                                                   ███ 
```

**Manage employees, leaves, and payroll from your terminal — or through any AI assistant that speaks MCP.**

---

## [QUICK START]

### 1. Install
```bash
pipx install kolay-cli
# or: pip install kolay-cli
```

### 2. Configure
```bash
kolay setup
# follow the prompts to authenticate and enable autocompletion
```

### 3. Verify
```bash
kolay doctor
```

---

## [THE GATEWAYS]

Detailed documentation is now split for your convenience. Choose your journey:

### [CLI Documentation](docs/CLI.md)
**For the Terminal Wizards.** 
Full command reference, output filters, interactive pickers, and local security (Keychain + Config Encryption). 
> "Everything you need to master your HR data from the shell."

### [MCP Documentation](docs/MCP.md)
**For the AI Architects.** 
Connect ChatGPT, Claude, Gemini, Mistral, and more. 15 layers of security (PII Masking, DLP, Circuit Breakers). 
> "Turn your LLM into a fully-capable HR operations lead."

### [Security and Privacy](docs/SECURITY.md)
**For the Compliance Officers.** 
Zero-trust architecture, encryption at rest, PII pseudonymization, and last-mile safety layers.
> "How we protect your most sensitive HR data."

---

## [ALPHA DISCLAIMER]

1. **UNOFFICIAL.** Independent lab application. Not a Kolay Yazilim A.S. product.
2. **WRITE OPERATIONS ARE REAL.** This is not a sandbox. Actions modify live HR data.
3. **TOKEN SECURITY.** You are responsible for your API token. Keep it private.

---

## [EMPHATIC UX HELP GUIDE]

**STOP STRUGGLING.** We refuse to let technical friction slow down your HR workflows. We designed Kolay CLI to be an effortless extension of your mind. If it's not working perfectly, here is exactly how to fix it right now:

- **[UNAUTHORIZED? SHRUNKEN KEYS?]** If your tools suddenly stop returning data, your API token has expired. **RE-ARM IMMEDIATELY** with `kolay auth login`. If you're running headless, let `keyrings.alt` securely manage your file-backed storage!
- **[NEED MORE EYES?]** You hold immense power. Don't guess. Append `--help` (e.g., `kolay person list --help`) to instantly reveal the hidden arsenals of filters, limits, and operational flags!
- **[TALK TO PROTOCOLS?]** Switch to `--json` to obliterate the pretty tables and output razor-sharp, structured JSON. Pipe it directly into `jq` and command your data like a true terminal wizard!
- **[FEELING THE LAG?]** We forged this client for raw speed. If it stutters, check your network or the Kolay status page—we do not compromise on performance!
- **[VIEW THE MAP]** Lost your bearings? Run `kolay config show`. It acts as your absolute compass, instantly exposing your active environment, base URL, and operational settings!
- **[ZERO TRUST, ZERO DRAMA]** Paralyzed by privacy concerns? Read our security documentation. We enforce ruthless PII masking, DLP egress scanners, and military-grade on-device AES-256-GCM encryption by default. 

**You are never alone.** Every error we throw is a tactical guide, never a dead end. If you hit an impenetrable wall, [report it](https://github.com/ezapmar/kolay-cli/issues) and we will tear it down together!

---

## [THE STACK]

- Python 3.10+
- Typer (Interactive CLI)
- FastMCP (Verifiable Smart Proxy)
- AES-256-GCM (AEAD Configuration & Memory Encryption)
- HMAC-SHA256 (PII Masking + Execution Receipts)

---

## [LICENSE]

MIT
