| name | Install AMPA Skill |
| description | Install, upgrade and maintain the ampa Worklog plugin by running the bundled installer script.
|
Purpose
Provide a simple, canonical installer for AMPA. Installs or upgrades the AMPA plugin for Worklog.
When to Use
User asks to "Install AMPA", "Install PM Agent", "Upgrade AMPA", "Upgrade PM Agent", "Change AMPA", "Configure AMPA" or similar.
Usage
NOTE: the work carried out by this skill does not require a work item, but the agent may optionally parse a work item token from the prompt to link the installation activity to a work item.
- Establish current status
Run wl plugins --json to discover whether the AMPA plugin is currently installed or not.
If AMPA is currently installed AND the skill was activated with either an install or upgrade request display a message indicated that the installation will be upgraded using
the existing configuration and instructing the requestor to request to "Configure AMPA" if they wish to change the configuraiton.
If there is currently no installation or the skill was activated with a request to configure or change AMPA continue to step 2, otherwise skip to step 3.
- Discord Bot Token
If a bot token was provided in the prompt that triggered this skill skip ahead to the next step.
Explain that a Discord bot token and channel ID are required for notifications from the AMPA agent and request the bot token and channel ID.
- Install/Upgrade AMPA
Always run the installer from the repository root (project root). This is important because the installer may start the local daemon and the daemon loads per-project configuration from <projectRoot>/.worklog/ampa/.env based on its working directory.
Run the installer from the repository root providing any configuration options we have been given. If no options have been given then run the installer with only the --yes flag.
If the prompt that triggered this skill indicates that we want to install or upgrade locally then run the installer with the --local flag and make sure your current working directory is the project root. For example:
cd /path/to/your/project
./skill/install-ampa/scripts/install-worklog-plugin.sh --local --bot-token <discord_bot_token> --channel-id <discord_channel_id> --yes
If you run the installer from another directory (for example the skill directory) the daemon started by the installer may use that directory as its cwd and will not see the project's .worklog/ampa/.env file, causing startup to fail when required env vars are missing.
Notes:
- The script writes logs and decision traces under
/tmp (e.g. /tmp/ampa_install_decisions.<pid> and /tmp/ampa_install_*.log).
- The installer bundles a minimal Python
ampa package in skill/install-ampa/resources/ampa_py/ampa so projects that lack a local ampa/ get a working copy. The installer will also look in ${XDG_CONFIG_HOME:-$HOME/.config}/opencode/ampa.
