Metadata-Version: 2.4
Name: atsys
Version: 0.2.1
Summary: Durable coding-task supervision with Codex integration and a local web dashboard
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/aetna000/atsys
Project-URL: Repository, https://github.com/aetna000/atsys
Project-URL: Issues, https://github.com/aetna000/atsys/issues
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Topic :: Software Development
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: nodejs-wheel-binaries<25,>=24
Dynamic: license-file

# AtSys

Installable supervision for general coding work: features, bug fixes, refactors, tests, builds, migrations and scripts.

```sh
pip install --upgrade atsys==0.2.1
cd /path/to/your/project
atsys init
```

Then open a Codex session in that repository and ask:

```text
$atsys Implement my feature, with tests, under automatic supervision.
```

The bundled skill teaches Codex to inspect the repository, prepare the task objective/plan and acceptance checks, configure bounded supervision/recovery, submit the task, and report a verified handoff. `atsys init` installs the repository skill, attaches the project, installs the macOS watchdog service, and starts the local dashboard. Existing source, AGENTS.md, Git hooks and provider credentials are preserved. Codex CLI and its native login must already be available for model-backed work.

```sh
atsys ui
atsys task list
atsys task status TASK_ID
atsys task watch TASK_ID
atsys doctor --config .atsys/tasks/task.json
atsys task show TASK_ID
atsys task stop TASK_ID
atsys service status
atsys task template --objective "My coding objective" --output .atsys/tasks/task.json
atsys task submit --config .atsys/tasks/task.json
```

The wheel contains the compiled backend and web assets. A Python dependency supplies Node 24; no npm install, development server, or source checkout is needed. State defaults to `~/.local/share/atsys`, overridable with `ATSYS_DATA_DIR`. Runtime state is never written into the installed package.

Version 0.2.1 adds setup checks and a private write/read pilot, progress-stall detection for newly configured Codex tasks, full recovery-plan handoff, readable status/watch/log commands and clearer dashboard phases. Watch is read-only; closing it does not stop the task. Existing task settings and evidence remain intact. Progress is worker-reported; only the independent validator establishes completion.

Tasks run independently of the terminal and dashboard. Codex diagnosis is read-only; separately authorized repair uses workspace-write. Completion requires the configured validator. Telegram is opt-in through the dashboard. Local sleep/power loss suspends work; generic commands run as the local user. Built-in OS service installation currently targets macOS; Linux requires a separately configured service manager. Windows process supervision is unsupported.

Use `atsys init --no-service --no-dashboard` for integration-only setup, `atsys integrate` to install just the Codex skill, and `atsys integrate --remove` to remove the unmodified managed skill. Reopen the Codex session if it was started before the skill was installed.
