# yothere

> The ambient cockpit for your AI agents. Hail a task, an agent does the work in the background, and it pings you back only when it needs your judgment. yothere is the interface and attention router; the work is done by a "brain" (Claude Code, or any harness that speaks the Brain Protocol).

Status: invite-only beta. Install: pip install yothere (Python >= 3.11, PyPI, MIT). The source repo is private.

## Docs
- [Introduction](https://yothere.ai/docs/): what yothere is and the core loop
- [Core concepts](https://yothere.ai/docs/concepts/): thread, runner, attention router, brain, cockpit
- [How it works](https://yothere.ai/docs/how-it-works/): architecture and the Brain Protocol
- [Cockpit tour](https://yothere.ai/docs/cockpit/): the /overview fleet board
- [Install](https://yothere.ai/docs/install/)
- [Quickstart](https://yothere.ai/docs/quickstart/)
- [CLI reference](https://yothere.ai/docs/cli/)
- [Onboarding](https://yothere.ai/docs/onboarding/)
- [Configuration](https://yothere.ai/docs/configuration/)
- [Self-hosting](https://yothere.ai/docs/self-host/)
- [Agent onboarding](https://yothere.ai/docs/for-agents/)
- [FAQ](https://yothere.ai/docs/faq/)
- [Changelog](https://yothere.ai/docs/changelog/)

## Set up yothere (for agents)
```bash
# 1. Install into a dedicated venv under the yothere home.
python3 -m venv ~/.yothere/venv
~/.yothere/venv/bin/pip install yothere

# 2. Zero-key smoke test: spawn -> work -> blocked -> reply -> done (~30s).
~/.yothere/venv/bin/yothere init --demo

# 3. Real init: create ~/.yothere layout, detect a brain, seed brains.yaml.
~/.yothere/venv/bin/yothere init

# 4. Configure (lead with YOTHERE_*; RELAY_* still resolves).
export YOTHERE_WORK_DIR="$HOME/code/your-project"   # NOT ~/Documents or ~/Desktop (macOS TCC)
export YOTHERE_NOTIFIER=command

# 5. Walk the onboarding steps (brain, workdir, consent, notifier, service, mcp, voice, first_thread).
python -m yothere.onboarding status
python -m yothere.onboarding apply <step> [--args '{"k":"v"}'] [--yes]

# 6. Install the always-on service (preview first).
python -m yothere.service install --dry-run
python -m yothere.service install

# 7. Spawn a thread and glance at the fleet.
yothere spawn "ship the pricing page fix"
yothere list
yothere board
```

## Notes
- Naming: lead with yothere / YOTHERE_* / ~/.yothere; RELAY_* / ~/.relay are legacy aliases that still work.
- The work dir must not be ~/Documents or ~/Desktop (macOS TCC blocks a background worker from reading them).
- The demo and the core need no API keys; only cockpit voice needs a Gemini key.
- Cockpit/voice server health: curl -s http://127.0.0.1:8767/healthz (the /overview board serves on the same port).
- The source repo (github.com/phios-ai/yothere) is private during the beta; install from PyPI.
- Contact: hey@yothere.ai