YAACLI CLI
TUI reference implementation for ya-agent-sdk.
Usage
Run with uvx:
uvx --from 'yaacli[rs]' yaacli
Install with uv:
uv tool install 'yaacli[rs]'
yaacli
[rs] installs the native Rust filesystem search binding. The equivalent extra-dependency form is:
uv tool install yaacli --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.
Update with uv:
uv tool upgrade yaacli
Install with pip:
pip install 'yaacli[rs]'
yaacli
Run as a module:
python -m yaacli
Built-in Skills
YAACLI ships with building-agents from the repository canonical source skills/agent-builder/.
The YA Claw deployment skill lives in skills/ya-claw-deploy/ and is published as YA_CLAW_DEPLOY_SKILL.zip during release.
The repository sync script keeps bundled skill files under packages/yaacli/yaacli/skills/ aligned.
Development
This package lives in the ya-mono workspace.
git clone git@github.com:YOUR_NAME/ya-mono.git
cd ya-mono
uv sync --all-packages
cp packages/yaacli/.env.example packages/yaacli/.env
YAACLI loads .env from packages/yaacli/.env and the current working directory.
Provider API keys can live in that .env file or in ~/.yaacli/config.toml under [env].
SDK and tool variables such as YA_AGENT_* and search API keys can also live in that same .env file because YAACLI loads it into the process environment at startup.
Use packages/ya-agent-sdk/.env.example as the reference list for SDK and tool variables.
The TUI detects the terminal's light or dark background at startup. For recognized local terminals such as VS Code's integrated terminal, it performs a short OSC 11 query; active queries are skipped over SSH to avoid delayed terminal responses. Detection then falls back to COLORFGBG, followed by the dark theme. Override detection in ~/.yaacli/config.toml when needed:
[display]
code_theme = "auto" # auto, dark, or light
The equivalent environment override is YAACLI_CODE_THEME=auto.
Codex OAuth credentials can be created once and reused from YAACLI:
uvx ya-oauth login codex
Then set model = "oauth@codex:gpt-5.5" in a YAACLI model profile.
Model profiles are configured in ~/.yaacli/config.toml and selected with /model inside the TUI:
[general]
model = "anthropic:claude-sonnet-4-5"
model_settings = "anthropic_adaptive_high"
model_cfg = "claude_200k"
[model_profiles.fast]
label = "Fast"
model = "openai-responses:gpt-5.6-luna"
model_settings = "openai_responses_luna"
model_cfg = "gpt5_270k"
[model_profiles.pro]
label = "GPT-5.6 Pro"
model = "openai-responses:gpt-5.6"
model_settings = "openai_responses_pro"
model_cfg = "gpt5_270k"
[model_profiles.sol]
label = "GPT-5.6 Sol"
model = "openai-responses:gpt-5.6-sol"
model_settings = "openai_responses_max"
model_cfg = "gpt5_270k"
[model_profiles.codex_oauth]
label = "Codex OAuth"
model = "oauth@codex:gpt-5.5"
model_settings = "openai_responses_high"
model_cfg = "gpt5_350k"
[general] is the startup fallback profile. The last selected profile is remembered in ~/.yaacli/state.json and restored on the next launch when that profile still exists.
Shell command review is configured in ~/.yaacli/config.toml under security.shell_review:
[security.shell_review]
enabled = true
model = "gateway@openai-responses:gpt-5.4-mini"
model_settings = "openai_responses_low"
on_needs_approval = "defer"
risk_threshold = "high"
When enabled, model is required. model_settings accepts SDK preset names or an inline TOML table. risk_threshold defaults to high and controls when the configured action triggers.
Run CLI tests from the workspace root:
make test-cli
Clipboard Image Paste
Plain terminal paste always inserts text into the input box.
Use Ctrl+V or /paste-image to attach an image from the system clipboard.
On macOS terminal apps over SSH, map Command+Shift+V to send Ctrl+V if you want a native-feeling shortcut.
YAACLI reads clipboard images through Pillow first on macOS and Windows.
macOS also reads Finder-copied image files through Cocoa pasteboard APIs via pyobjc-framework-Cocoa.
Linux image paste still relies on wl-paste on Wayland or xclip on X11.
License
BSD 3-Clause License. See the repository license.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file yaacli-1.11.2.tar.gz.
File metadata
- Download URL: yaacli-1.11.2.tar.gz
- Upload date:
- Size: 310.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3bb5d5c7952900e12cf05c3fd2a5bc28e64ce5752a8cabd508875e50a34adeda
|
|
| MD5 |
ce5610789e27321c55a718901f2733d2
|
|
| BLAKE2b-256 |
d54e4089e51f2e3725f3740e0e1f0b24ce8c2846bbdb5769b25f85ea778fc648
|
File details
Details for the file yaacli-1.11.2-py3-none-any.whl.
File metadata
- Download URL: yaacli-1.11.2-py3-none-any.whl
- Upload date:
- Size: 255.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6bb13e489e867c32b36674d76ecd119161e850cc1b7320a74c802363deacee30
|
|
| MD5 |
2dac548b1080d5b84e1f73a4ba91d38f
|
|
| BLAKE2b-256 |
ce086501742ff18ac5edfdae4c6b7d1c5ce99bdb78f77781657519c030ad085e
|
