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
- 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), thepackage.jsonscripts orMakefiletargets, version files (.nvmrc,.node-version,.tool-versions,rust-toolchain.toml,.python-version, theenginesandpackageManagerfields), the README's run instructions, and.env.exampleordocker-compose.ymlfor 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. - 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. - Prove it with
prepare_project(project, worktree). Done when the reply hasstart.staterunningandstart_logshows the app ready, such as a listening line. Otherwise readinstall_log,start_logand the refusal, change the profile in step 2, and call again. A cancelledprepare_projectkeeps building; call it again to join the same build. - Report to the developer the Test Credential names
set_project_profilelisted asmissing, 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/. - 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.