Skip to content

Add AGENTS.md with Cursor Cloud dev environment instructions #84

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
EXboys wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

Add AGENTS.md with Cursor Cloud dev environment instructions #84

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 52 additions & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
# AGENTS.md

## Cursor Cloud specific instructions

### Overview

SkillLite is a Rust workspace (`Cargo.toml` at repo root) with a Python SDK (`python-sdk/`). The main binary is `skilllite` built from `skilllite/` crate. The desktop app (`crates/skilllite-assistant/`) is excluded from the workspace and is optional.

### Running checks (mirrors CI)

Rust:
```bash
cargo fmt --check
cargo clippy --all-targets -- -D warnings
cargo test
cargo deny check bans
```

Python SDK (from `python-sdk/`):
```bash
ruff check .
ruff format --check .
mypy skilllite
pytest
```

### Building

```bash
cargo build -p skilllite # full binary (debug)
cargo build -p skilllite --release # release binary
```

### Running skills

```bash
# Sandbox Level 3 (default) requires kernel namespace support (bwrap).
# In Cloud Agent VMs (nested containers), bwrap namespace creation fails with
# "Resource temporarily unavailable". Use Level 1 for testing:
SKILLLITE_SANDBOX_LEVEL=1 ./target/debug/skilllite run .skills/calculator '{"operation":"add","a":1,"b":2}'

# For skills that trigger security scan (non-TTY stdin blocks approval):
SKILLLITE_SANDBOX_LEVEL=1 SKILLLITE_AUTO_APPROVE=1 ./target/debug/skilllite run .skills/text-processor '{"text":"test","operation":"uppercase"}'
```

### Key gotchas

- **Sandbox level in Cloud VMs**: `bwrap` (bubblewrap) requires unprivileged user namespaces which are unavailable inside the Cloud Agent container. Set `SKILLLITE_SANDBOX_LEVEL=1` for functional testing of skill execution logic. Security sandbox integration tests should be validated in CI (ubuntu-latest has namespace support).
- **python3-venv**: Required for skill execution (`ensure_environment` creates venvs). Install with `sudo apt-get install -y python3.12-venv`.
- **PATH for Python dev tools**: `ruff`, `mypy`, `pytest` install to `/home/ubuntu/.local/bin` — ensure it's on PATH.
- **Rust toolchain**: The project uses latest stable Rust. Run `rustup default stable` if needed.
- **Desktop app (Tauri)**: Not part of the default workspace (`exclude = ["crates/skilllite-assistant"]`). Requires Node.js + GTK libs on Linux. Skip unless specifically needed.
Loading