groove-admin-config
Create or update .groove/index.md config interactively. Run before groove install.
By andreadellacorte · 580 installs
npx skills add andreadellacorte/groove --skill groove-admin-config
Source repository · Upstream listing
<! groove:managed — do not edit; changes will be overwritten by groove update
groove admin config
Outcome
.groove/index.md is created or updated with values confirmed by the user. The git strategy is applied immediately. User is ready to run /groove admin install .
Acceptance Criteria
.groove/index.md exists with all config keys populated
Each key was either confirmed by the user or accepted as default
Git strategy is applied ( .groove/.gitignore written) before exiting
User is shown a summary of the final config and told to run /groove admin install
Steps
If defaults is passed: skip all prompts, apply all defaults, and proceed directly to writing the config (step 1 of "After all keys are confirmed"). Report the defaults being applied.
Otherwise, walk the user through each config key in order. For each key: show the current value (or default if new), explain what it does, and ask to confirm or change.
Keys and defaults
Key Default Options Question to ask
tasks.storage beans beans \ linear \ github \ none "Which task backend? beans tracks tasks as markdown files in your repo."
tasks.list limit 15 positive integer "Max tasks shown by task list? (default: 15)"
tasks.analyse limit 30 positive integer "Max tasks shown by task analyse? (default: 30)"
memory.review days 5 positive integer "How many recent business days to review at daily start? (default: 5)"
git.memory ignore all ignore all \ hybrid \ commit all "Git strategy for memory logs? ignore all keeps them local, hybrid commits logs but ignores sessions, commit all commits everything."
git.tasks ignore all ignore all \ commit all "Git strategy for task files (.groove/tasks/)? ignore all keeps them local, commit all tracks them in git."
git.hooks commit all ignore all \ commit all "Git strategy for hooks (.groove/hooks/)? commit all shares hooks with the team, ignore all keeps them local."
groovebook andreadellacorte/groovebook <owner /<repo or blank "Groovebook repo for sharing learnings? Default: andreadellacorte/groovebook. Leave blank to disable."
After all keys are confirmed:
1. Write .groove/index.md with confirmed values and groove version: <installed version
2. Apply git strategy — write .groove/.gitignore (see constraints)
3. Show summary of written config
4. Tell user: "Run /groove admin install to install backends."
Constraints
If .groove/index.md already exists, pre fill each question with the current value
Always write groovebook: (default andreadellacorte/groovebook ; blank = disabled). Memory path ( .groove/memory/ ) and specs path ( .groove/memory/specs/ ) are hardcoded — do not prompt for them.
If defaults is passed, apply all defaults without any prompting — used by groove admin install for zero friction first time setup
If other arguments are provided (e.g. tasks=linear git.memory=hybrid ), apply them without prompting and use defaults for any unspecified keys
Always write groove version: matching the installed version from skills/groove/SKILL.md
Git strategy → .groove/.gitignore
After writing .groove/index.md , generate .groove/.gitignore from the git. sub keys:
Component Strategy Entry added to .groove/.gitignore
git.memory ignore all memory/
git.memory hybrid memory/sessions/
git.memory commit all (none)
git.tasks ignore all tasks/
git.tasks commit all (none)
git.hooks ignore all hooks/
git.hooks commit all (none)
Write the generated entries to .groove/.gitignore , replacing the file entirely. If no entries are generated (all commit all ), write an empty file with a comment: groove git strategy: commit all .
Always append these lines at the end of .groove/.gitignore , regardless of strategy:
If .groove/ is listed in the root .gitignore , warn the user: "Note: .groove/ is in your root .gitignore — any commit all strategies require removing it."
Do not modify the root .gitignore automatically — flag it for the user to resolve