diff --git a/skills/kugetsu/SKILL.md b/skills/kugetsu/SKILL.md index ddefcc3..4308870 100644 --- a/skills/kugetsu/SKILL.md +++ b/skills/kugetsu/SKILL.md @@ -48,6 +48,44 @@ A default config file is created during `kugetsu init` with commented examples: |----------|---------|-------------| | `MAX_CONCURRENT_AGENTS` | 3 | Maximum number of concurrent dev agents | +### Environment Variables for Agents + +Agents receive environment variables through env files, not command-line injection. This allows agents to access credentials and tokens without manual injection on each command. + +**Files created during `kugetsu init`:** +- `~/.kugetsu/env/default.env` - Variables for all agents +- `~/.kugetsu/env/pm-agent.env` - Variables for PM agent (overrides default) + +**Commands:** +```bash +kugetsu env list # List all env files +kugetsu env show [agent] # Show env file contents (values masked) +kugetsu env set [agent] # Set a variable +kugetsu env get [agent] # Get a variable value +kugetsu env rm [agent] # Remove a variable +``` + +**Example - Setting GITEA_TOKEN:** +```bash +# Set token for PM agent +kugetsu env set GITEA_TOKEN ghp_xxx pm-agent + +# Verify (token masked in output) +kugetsu env show pm-agent + +# Agent now has GITEA_TOKEN when delegated to +``` + +**Sensitive values are automatically masked** in logs and display: +- GITEA_TOKEN, GITHUB_TOKEN, GITLAB_TOKEN +- API_KEY, PASSWORD, TOKEN, SECRET + +**Usage in delegation:** +```bash +# PM agent will have GITEA_TOKEN from pm-agent.env +kugetsu delegate "post comment on #69" +``` + ## Architecture ### Session Pattern