Metadata-Version: 2.4
Name: optio-grok
Version: 0.1.0
Summary: Run Grok Build (xAI) as an optio task; local subprocess or remote via SSH; ttyd-served TUI iframe.
Author-email: Kristof Csillag <kristof.csillag@deai-labs.com>
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/deai-network/optio
Project-URL: Repository, https://github.com/deai-network/optio
Project-URL: Issues, https://github.com/deai-network/optio/issues
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Code Generators
Classifier: Framework :: AsyncIO
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: optio-core<0.4,>=0.3
Requires-Dist: optio-host<0.3,>=0.2
Requires-Dist: optio-agents<0.4,>=0.3
Requires-Dist: asyncssh>=2.14
Requires-Dist: aiohttp>=3.9
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"

# optio-grok

Run Grok Build (xAI) as an `optio` task — either as a local subprocess
or on a remote host over SSH — with the interactive TUI embedded in the
optio dashboard via an iframe widget served by `ttyd`.

## Install

```bash
pip install optio-grok
```

Requires Python 3.11+. Pulls `optio-core`, `optio-host`, `optio-agents`,
`asyncssh`, and `aiohttp`.

## What it does

Grok Build is a near-twin of Claude Code. optio-grok adapts the
`optio-claudecode` machinery: it launches `grok` inside a detached tmux
session, serves the TUI over `ttyd`, and coordinates with the host
harness through the `optio.log` keyword channel (STATUS / DELIVERABLE /
DONE / ERROR). The agent reads its task from an `AGENTS.md` file planted
in the workdir.

### Isolation

Each task runs under an isolated `HOME` (`<workdir>/home`) with
`GROK_HOME` pointing at `<workdir>/home/.grok`. Grok ships a
claude-compat layer, so `CLAUDE_CONFIG_DIR` is pinned at
`<workdir>/home/.claude` to keep the operator's real `~/.claude`
configuration, hooks, and instructions from leaking into the task.
`--no-leader` is always passed so tasks never share a grok backend.

## Status

Stage 0 (MVP): iframe/ttyd mode, local host. Resume, seeds,
conversation mode, and filesystem isolation arrive in later stages.
