keek-setup

Installation
SKILL.md

keek setup

A Project Profile tells keek how to install and start a Project's App Under Test in a sandbox on this machine. You write it with set_project_profile and try it with prepare_project. keek detects nothing itself: every value comes from what you read in the repository.

Steps

  1. Read the repository. Find what installs it and what starts it: the lockfile (package-lock.json, pnpm-lock.yaml, yarn.lock, Cargo.lock, uv.lock, poetry.lock), the package.json scripts or Makefile targets, version files (.nvmrc, .node-version, .tool-versions, rust-toolchain.toml, .python-version, the engines and packageManager fields), the README's run instructions, and .env.example or docker-compose.yml for the variables and services the app expects. Done when you can name the install command, the start command, each pinned toolchain version, every variable the app reads, and every host service it connects to.
  2. Write the profile with set_project_profile(project, profile, credentials?), choosing values with the rules below. Done when it returns the written TOML. A refusal names the key and the reason; fix that key and call again.
  3. Prove it with prepare_project(project, worktree). Done when the reply has start.state running and start_log shows the app ready, such as a listening line. Otherwise read install_log, start_log and the refusal, change the profile in step 2, and call again. A cancelled prepare_project keeps building; call it again to join the same build.
  4. Report to the developer the Test Credential names set_project_profile listed as missing, and the host services the app needs running, such as a database in Docker. When the app needs a sample input uploaded, tell the developer to place it in ~/.config/keek/projects/<project>.files/.
  5. Offer the Verification section. Ask the developer whether to add the section below to the repository's agent file, and write it only on a yes. Done when the file names the Project or the developer declined.

Profile format

The profile is one TOML table. Only start is required. set_project_profile takes the same keys as JSON.

Installs
1
Repository
radimsem/keek
First Seen
8 days ago