Metadata-Version: 2.4
Name: starray-cli
Version: 0.1.1
Summary: CLI-first Starray
Author: Tom Van Besien
License: Apache License 2.0
Project-URL: Homepage, https://github.com/Tomvbe/sarray
Project-URL: Repository, https://github.com/Tomvbe/sarray
Project-URL: Issues, https://github.com/Tomvbe/sarray/issues
Keywords: ai,cli,multi-agent,orchestration,langgraph
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: Apache Software License
Requires-Python: <3.14,>=3.13
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Starray

Phase 0 baseline scaffold for a CLI-first Starray.

## Install

```bash
pipx install starray
starray --version
```

If you prefer source install:

```bash
git clone <repo-url>
cd starray
pyenv install 3.13.12 --skip-existing
pyenv local 3.13.12
python -m venv .venv
source .venv/bin/activate
pip install -e .
starray
starray status
starray chat --message "hello"
starray --session-id <session_id>
starray chat --session-id <session_id>
```

## Python Version
- Required: `3.13.12`
- Supported range: `>=3.13,<3.14` (LangGraph dependency compatibility)

## Session Resume
- When chat exits, the CLI prints `Session saved: <session_id>`.
- Resume a session with:
  - `starray --session-id <session_id>` (interactive default)
  - `starray chat --session-id <session_id>`

## Interactive Commands
- `/status`: show active provider/model.
- `/session`: show current session id.
- `/help`: show available chat commands.
- `exit` or `quit`: save and exit.

## Release
- CI runs on pushes/PRs via `.github/workflows/ci.yml`.
- Publishing runs on tags like `v0.1.1` via `.github/workflows/publish.yml`.
- PyPI publishing uses repository secret `PYPI_API_TOKEN`.
- A helper installer script is available at `scripts/install.sh`.

## Layout
- `src/starray/`: CLI, config, logging, session primitives
- `configs/starray.toml`: provider/model configuration
- `docs/`: architecture notes and ADRs
- `tests/`: baseline tests
