Yet Another Agents

• packages/ya-agent-environment — Environment abstractions for general agents
• packages/ya-agent-sdk — Python SDK for building AI agents with Pydantic AI
• packages/ya-agent-stream-protocol — shared stream protocol adapters between ya-agent-sdk and applications
• packages/ya-oauth — OAuth login, refresh, logout, token storage, and CLI for subscription-backed providers
• packages/ya-oauth-provider — Pydantic AI provider helpers for OAuth-backed model access
• packages/yaacli — TUI reference implementation built on top of ya-agent-sdk
• packages/ya-claw — workspace-native single-node runtime web service with WorkspaceProvider, in-process runtime state, schedules, bridges, and SQLite-first storage
• packages/ya-agent-platform — WIP stateless agent service with TBD scope

• apps/ya-claw-web — Vite + React web shell for YA Claw

• packages/ — publishable workspace members
• apps/ — frontend applications and user-facing shells
• skills/ — canonical skill sources and reference material
• examples/ — runnable SDK examples
• scripts/ — repository automation scripts
• .github/ — CI and release workflows

• skills/agent-builder/ — source of truth for the agent-builder skill bundled into YAACLI as building-agents
• skills/ya-claw-deploy/ — source of truth for the YA Claw deployment skill published as YA_CLAW_DEPLOY_SKILL.zip

Prerequisites:

• Python 3.11+
• uv
• make
• Node.js with corepack available for the web app

Clone the repository and install the workspace environment:

git clone https://github.com/wh1isper/ya-mono.git
cd ya-mono
make install

Install the canonical skills into ~/.agents/skills:

make install-skills

This installs agent-builder and ya-claw-deploy for local agent use.

Install published tools with native filesystem search enabled:

uv tool install 'yaacli[rs]'
uv tool install 'ya-claw[rs]'

uv tool install accepts extras in the package requirement. The equivalent extra-dependency form is uv tool install yaacli --with ya-ripgrep-core or uv tool install ya-claw --with ya-ripgrep-core. ya-ripgrep-core is a library dependency, so --with is the matching uv form; --with-executables-from applies to companion packages that also expose CLI executables.

Recommended starting points:

• Read skills/agent-builder/SKILL.md for the main agent-building workflow
• Read skills/agent-builder/README.md for the skill file map
• Copy examples/.env.example to examples/.env when running SDK examples
• Copy packages/ya-agent-sdk/.env.example to packages/ya-agent-sdk/.env when developing the SDK or configuring SDK/tool variables for workspace apps
• Copy packages/yaacli/.env.example to packages/yaacli/.env or your current working directory .env when developing YAACLI
• Run examples from examples/ for end-to-end usage patterns

Run Codex through your ChatGPT subscription with a local OAuth credential store:

uv run --package ya-oauth ya-oauth login codex

Then use oauth@codex:gpt-5.5 in SDK, YAACLI, or YA Claw profiles. Credentials live in ~/.yaai/auth.json.

Read the deployment and runtime docs:

• skills/ya-claw-deploy/SKILL.md
• skills/ya-claw-deploy/references/docker.md
• packages/ya-claw/spec/README.md
• packages/ya-claw/spec/00-overview.md
• packages/ya-claw/spec/01-configuration-and-workspace-provider.md

Prepare the runtime environment and start the service:

cp packages/ya-claw/.env.example packages/ya-claw/.env
make run-claw

SDK and tool variables for YA Claw workflows live in packages/ya-agent-sdk/.env.example.

Run the web shell:

make web-dev

Bridge commands live under the main YA Claw CLI:

uv run --package ya-claw ya-claw bridge ls
uv run --package ya-claw ya-claw bridge run lark
uv run --package ya-claw ya-claw bridge serve lark

Build the images:

make docker-build-claw
make docker-build-claw-workspace
make docker-build-platform

• Dockerfile.ya-claw — YA Claw image build
• Dockerfile.ya-claw-workspace — official YA Claw Docker workspace image build
• Dockerfile.ya-agent-platform — YA Agent Platform image build

Run repository checks:

make lint
make check
make test

• ya-agent-environment README
• ya-agent-sdk README
• ya-oauth README
• ya-oauth-provider README
• yaacli README
• ya-claw README
• ya-agent-platform README
• agent-builder skill
• YA Claw deployment skill
• Contributing Guide

BSD 3-Clause License. See LICENSE.