Metadata-Version: 2.4
Name: dekk
Version: 1.3.1
Summary: Reusable environment detection, activation, and wrapper tooling for developer CLIs.
Project-URL: Homepage, https://github.com/randreshg/dekk
Project-URL: Documentation, https://github.com/randreshg/dekk/tree/main/docs
Project-URL: Repository, https://github.com/randreshg/dekk
Project-URL: Issues, https://github.com/randreshg/dekk/issues
Project-URL: Changelog, https://github.com/randreshg/dekk/blob/main/CHANGELOG.md
Author-email: Randres Herrera <randres2011@gmail.com>
Maintainer-email: Randres Herrera <randres2011@gmail.com>
License: MIT
License-File: LICENSE
Keywords: cli,conda,detection,developer-tools,environment,toolchain,workspace
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: platformdirs>=4.9.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.0.0
Requires-Dist: tomli-w>=1.0.0
Requires-Dist: tomli>=2.0.0; python_version < '3.11'
Requires-Dist: typer>=0.9.0
Provides-Extra: all
Requires-Dist: tully>=0.1.0; extra == 'all'
Provides-Extra: dev
Requires-Dist: build>=1.2.1; extra == 'dev'
Requires-Dist: mypy>=1.8; extra == 'dev'
Requires-Dist: pytest-cov>=4.1; extra == 'dev'
Requires-Dist: pytest-mock>=3.12; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.2; extra == 'dev'
Requires-Dist: twine>=5.0.0; extra == 'dev'
Requires-Dist: types-psutil>=7.0.0.20260302; extra == 'dev'
Requires-Dist: types-pyyaml>=6.0.12.20250915; extra == 'dev'
Provides-Extra: tracking
Requires-Dist: tully>=0.1.0; extra == 'tracking'
Description-Content-Type: text/markdown

# dekk

Make project CLIs runnable with one config and zero manual activation.

## Install

```bash
pipx install dekk
```

Fallback:

```bash
python -m pip install --upgrade dekk
```

## Minimal Setup

```bash
dekk install ./tools/cli.py
```

If `.dekk.toml` is missing, `dekk install`, `dekk wrap`, and `dekk agents init`
create a starter file from the repo context first.

Explicit template-driven setup is still available:

```bash
dekk init --example conda
eval "$(dekk activate --shell bash)"
```

Optional (no activation after this):

```bash
dekk wrap myapp ./tools/cli.py
```

Worktree-safe default:

```bash
dekk install ./tools/cli.py        # no shell rc PATH edits by default
dekk install ./tools/cli.py --update-shell
```

Project command routing (uses nearest `.dekk.toml`):

```bash
dekk myapp server --port 8080
```

This is worktree-friendly by default:

- `dekk` walks up from your current directory to find the nearest `.dekk.toml`
- the app name must match `[project].name`
- the command runs with `cwd` set to that project root, not whatever nested
  directory you happened to be in
- activation is scoped to that project config before the command runs

That means `dekk myapp server` works correctly from a repo root, a nested
subpackage, or a separate Git worktree for the same project, without relying
on global shell state.

## Agents

Source of truth: `.agents/`

```bash
dekk agents init
dekk agents generate --target all
dekk agents clean --target codex
dekk agents install        # optional (installs Codex skills to ~/.codex/skills)
```

Generated files (examples): `AGENTS.md`, `CLAUDE.md`, `.cursorrules`, `.github/copilot-instructions.md`, `.agents.json`

## Docs

- [Getting Started](docs/getting-started.md)
- [.dekk.toml Specification](docs/spec.md)
- [Agent Workflows](docs/agents.md)
