Yet Another Agents

• packages/ya-agent-sdk — Python SDK for building AI agents with Pydantic AI
• 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.

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

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-sdk 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.