Kiro BuddyBeta build
IDECLIGlobalKiro BuddyProgressnpmGitHub

Floating status pet for Kiro

Kiro Buddy

A cute desktop companion that reacts to Kiro agent activity: working, asking for input, done, errors, and spec-driven design phases.

Unofficial community project made by Jagatees. Kiro Buddy is not assigned, sponsored, endorsed, or maintained by AWS.

Install now View npm View repo
Kiro Working
Kiro Working animated Kiro Buddy sprite
Prompt is running000
Working

Kiro starts thinking

Asking

Waiting for your input

Done

Agent run completed

Spec phases

Design, Requirements, Task List

Kiro IDE Buddy

A small visual signal for long agent runs.

Watch Buddy react inside Kiro while the command hook moves through working, asking, done, and spec-phase states.

Kiro IDE Buddy changing animation states inside Kiro
Kiro IDE Buddy animation demo

Kiro IDE setup

One installer command for Kiro IDE.

macOS and Windows use the same Buddy installer. Open your Kiro project folder in Terminal or PowerShell, run the command once, then use the slash commands inside Kiro IDE chat.

macOS + WindowsSame command

Run Buddy from your Kiro project folder.

Only the `cd` path changes by platform. After that, the `npx` installer and the Kiro IDE slash commands are identical.

macOS Terminalcd ~/my-kiro-project
Windows PowerShellcd C:\path\to\my-kiro-project
Terminal or PowerShell
$ node -v
$ npm -v
$ cd <your-kiro-project>
$ npx -y @jagatees/kiro-buddy install

Run inside Kiro IDE chat

Kiro IDE chat
> /buddy-open
> /buddy-test
macOS Kiro IDE setup walkthrough
Windows Kiro IDE setup walkthrough

Kiro CLI setup

One Buddy CLI hook flow for Terminal.

macOS and Windows use the same Buddy CLI hook commands after Kiro CLI login. Prepare your project folder in Terminal or PowerShell, then run the shared hook flow from that folder.

macOS + WindowsSame CLI hooks

Install Buddy CLI hooks once per project.

Only the folder command changes by platform. The Kiro CLI login, Buddy hook install, Buddy open command, and agent chat command are shared.

macOS Terminalmkdir -p ~/my-kiro-project && cd ~/my-kiro-project
Windows PowerShellmkdir my-kiro-project; cd .\my-kiro-project
Terminal or PowerShell
$ kiro-cli --version
$ kiro-cli login
$ npx -y @jagatees/kiro-buddy cli install
$ npx -y @jagatees/kiro-buddy cli open
$ kiro-cli chat --agent kiro-buddy-cli

Result

  • Kiro CLI discovers the `kiro-buddy-cli` agent config.
  • Buddy opens when the terminal agent starts.
  • Buddy switches between working, asking, and done.
  • `cli run` is available for one Buddy per terminal.
macOS Kiro CLI setup walkthrough
Windows Kiro CLI setup walkthrough

Global command

Install once globally for shorter commands.

This is optional. Use it if you prefer `kiro-buddy` commands instead of running `npx -y @jagatees/kiro-buddy` every time.

Terminal
$ npm install -g @jagatees/kiro-buddy
$ kiro-buddy install
$ kiro-buddy cli install
$ kiro-buddy cli open

Desktop companion

A small floating Buddy stays on top while Kiro runs, so agent state is visible without checking logs.

Hook powered

Install writes Kiro Agent Hooks, slash agents, and a status runner into the current workspace.

Phase aware

Buddy can show working, asking, done, error, and spec-driven Design, Requirements, or Task List states.