daftAI-Amp-plugins

English | 中文

Amp plugins shared by daftAI for enhancing the Amp CLI experience.

⚠️ The Amp Plugin API is experimental and may have breaking changes. See Plugin API docs.

Prerequisites

• Amp CLI installed via binary method (not npm)
• amp binary available in your PATH

Limitations:

• Plugins only work in the Amp CLI, not the editor extension
• Plugins only work with binary-installed Amp, not npm install

Installation

Option 1: Ask the Agent

Simply tell Amp:

Please install plugins from github.com/daftAI2026/daftai-amp-plugins

Option 2: Manual Install

Clone the repository first:

git clone https://github.com/daftAI2026/daftai-amp-plugins.git
cd daftai-amp-plugins

Then copy the plugin to one Amp plugin directory.

System plugin on macOS/Linux (all projects):

mkdir -p ~/.config/amp/plugins
cp plugins/daftai-usage-monitor/usage-monitor.ts ~/.config/amp/plugins/

System plugin on Windows PowerShell (all projects):

New-Item -ItemType Directory -Force "$env:USERPROFILE\.config\amp\plugins"
Copy-Item plugins/daftai-usage-monitor/usage-monitor.ts "$env:USERPROFILE\.config\amp\plugins\usage-monitor.ts"

Project plugin (run from your project root):

mkdir -p /path/to/your/project/.amp/plugins
cp plugins/daftai-usage-monitor/usage-monitor.ts /path/to/your/project/.amp/plugins/

Getting Started

1. Start Amp:

   amp

2. Send any prompt — installed plugins will activate automatically.
3. To inspect plugins, press Ctrl-o and select plugins: list.
4. To reload plugins after changes, press Ctrl-o and select plugins: reload.

Available Plugins

Plugin	Description
usage-monitor	Displays your Amp free credits and paid balance automatically, then refreshes after every agent turn.

usage-monitor

Supports macOS, Linux, and Windows. When the plugin loads, your usage appears automatically in supported Amp status-item surfaces and keeps refreshing after every agent turn. If status items are unavailable, the plugin falls back to a notification after agent turns.

Track your free credits & paid balance in one glance.

usage-monitor.preview.mp4

Project Structure

daftAI-amp/
├── README.md
├── README.zh.md
├── CHANGELOG.md
├── CHANGELOG.zh.md
├── LICENSE
├── .gitignore
├── assets/
│   └── usage-monitor/
│       └── preview.mp4
└── plugins/
    └── daftai-usage-monitor/
        └── usage-monitor.ts

Contributing

Feel free to submit issues and pull requests.

License

MIT License