Metadata-Version: 2.4
Name: codexd
Version: 0.1.2
Summary: Codex daemon for delegated repo tasks and reviewable PRs.
Project-URL: Homepage, https://github.com/agentculture/codexd
Project-URL: Issues, https://github.com/agentculture/codexd/issues
Author: AgentCulture
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development
Requires-Python: >=3.12
Description-Content-Type: text/markdown

# codexd

Codex daemon for delegated repo tasks and reviewable PRs.

`codexd` is an AgentCulture sibling project. It is currently in initial
scaffold state: package metadata, Culture registration, Codex repo guidance,
repo-local skills, CI, lint, and tests exist; daemon task orchestration is not
implemented yet.

## Quick Start

```bash
uv sync
uv run python -m codexd --version
uv run pytest -n auto --cov=codexd
```

## Codex Conventions

- Repository instructions live in `AGENTS.md`.
- Repo-local skills live in `.agents/skills` and are auto-discovered when Codex
  starts inside this repository.
- Use `/skills` or `$` completion to find available skills. Invoke the repo
  workflow skills as `$cicd` and `$communicate`; `/cicd` and `/communicate` are
  not Codex skill invocations.
- `.agents/skills.local.yaml.example` documents optional per-machine values
  for local workflow tooling. A copied `.agents/skills.local.yaml` is ignored
  by Git and is not used for Codex skill discovery.

The local `$HOME/.codex/skills` path is treated as an environment-specific
install location, not a committed repository layout. Restart Codex if newly
changed repo-local skills do not appear in `/skills`.
