Metadata-Version: 2.4
Name: kolay-cli
Version: 0.1.0a0
Summary: Command-line interface for Kolay IK (https://apidocs.kolayik.com)
Author: Tunc Aucer
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
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"
Provides-Extra: linux
Requires-Dist: keyrings.alt>=5.0; extra == "linux"
Provides-Extra: installer
Requires-Dist: pyinstaller>=6.0; extra == "installer"
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

# kolay-cli

An unofficial command-line interface and MCP server for Kolay İK.

## Notice

This is an unofficial lab project. It is not an official product of Kolay Yazılım A.Ş. They are not responsible for data loss or system errors. You are responsible for your API tokens. Use the tools with care. They change live data.

## Install

Install via standalone wizard:
1. Download the [latest release](https://github.com/ezapmar/kolay-cli/releases).
2. Run `kolay-setup`.
3. Accept the disclaimer and follow the prompts.

Or install via pip:
```bash
pipx install kolay-cli
kolay setup
```

## Example

```bash
kolay person list
kolay leave create --type annual --start 2026-03-01 --end 2026-03-03
```

## Commands

Commands follow the `kolay <resource> <action>` pattern.

| Resource | Action |
|---|---|
| auth | login, logout, status |
| config | show, set |
| person | list, view, summary, create, update, terminate |
| leave | list, create |
| timelog | list, create, delete |
| training | list, create, delete |
| calendar | list, create, update, delete |
| unit | tree |
| doctor | health check |

## MCP Server

Integrate Kolay İK with AI assistants.

```bash
kolay mcp install
```

## Output Modes

* `--json`: Machine-readable output.
* `--yes`: Bypass confirmations.
* `--debug`: Write HTTP traces to `~/.config/kolay/debug.log`.

## Exit Codes

| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | Error |
| 2 | Bad input |
| 3 | Not found |
| 4 | Auth error |
| 5 | Conflict |

## Links

* [API Docs](https://apidocs.kolayik.com)
* [GitHub](https://github.com/ezapmar/kolay-cli)
