sample-kiro-assistant

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

sample-kiro-assistant

★ 46 Open GitHub ↗

No description available.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Kiro Assistant - an infinitely resourceful agent to help as a coworker and as a personal assistant

Kiro Assistant is a general purpose agent with **500+ capabilities & vast array of skills**.The idea behind Kiro Assistant is that it will help every member of the society and not just software developers. 
It can work along side you as your coworker and help with your work across your business domains: Sales, Marketing, HR, Legal, FSI, Telco etc. All you have to add it is tools (MCPs) and skills. The system can load skills based on context. It can invoke appropriate tools based on context. That is what makes the system truly general purpose.

To summarize:
- 🚀 **Native Electron desktop app** Can help with tasks that you didn't know Kiro could help you with: make Audio, Video, Presentations, help you file expenses, cancel subscriptions and so on.
- 🧠 **Powered entirely by `kiro-cli`** 
- 🧩 **500 MCPs through Composio. Additional MCPs for Excel, Pencil Desktop etc** surfaced inside Settings
- 📂 **Auto-provisioned workspaces** per session under `~/Documents/workspace-kiro-assistant/<task-id>`
- 💾 **SQLite-backed history** so conversations stream in real time and persist across launches

---

# Kiro Assistant is for everyone in the family & every profession

We show that Kiro is not only for software developers, but every member of the society, for every member in your family (accessabilty features like voice coming soon..)

![Kiro Assistant Concept](https://raw.githubusercontent.com/aws-samples/sample-kiro-assistant/main/images/KiroCoworkConcept.png)

---

# Kiro Assistant can be customized with Kiro Powers - collection of tools and skills

With Kiro Powers, Kiro is useful to vast array of professionals. Just define skills and tools. Skills are plane .md files that are loaded depending on context. They describe how to do specific things (e.g. creating powerpoint as per your style, building spreadsheets as per your preferrence). Tools give access to Kiro to various softwares and SaaS products on your behalf.

![Kiro Power Concept](https://raw.githubusercontent.com/aws-samples/sample-kiro-assistant/main/images/Kiro_Powers_for_Professionals.png)

Soon you will be able to get Kiro Powers for professional scenarios from [Kiro Hub](https://kirohub.dev/).
Organizations can define Kiro Powers and share between teams.

![Kiro Power Concept](https://raw.githubusercontent.com/aws-samples/sample-kiro-assistant/main/images/Kiro_Hub.png)

---

# Kiro Assistant is highly versatile

Kiro Assistant has 500+ tools through Composio (ElevanLab for audio, HeyGen for video, Gmail, X tools etc.).

It can also use local MCPs for Excel and other development environments like Blender, Pencil Desktop etc. As long as you have an MCP, it will figure out how to use it opportunistically.
We have added **playwright** MCP to allow it ability to handle browsers.
We have added **ZAI MCPs** to give it ability to deal with PDFs, Images etc. when the model being used is not multimodal.

It also has a skill repository, e.g. to make 3D animation with threejs and professional video with Remotion. You can add more skills. Skills are loaded dynamically.
That is how skills work.

Even we don't know what it is fully capable of. Please give it a shot!

![Kiro Assistant Versatility](https://raw.githubusercontent.com/aws-samples/sample-kiro-assistant/main/images/KiroApplications.png)

---

## Deceptively simple interface

Task: Make me an audio podcast of 3 minutes on Moltbot controversy. I want to upload it to youtube, so create a display image and combine it with mp3 to give me an MP4.

![Kiro Assistant UX](https://raw.githubusercontent.com/aws-samples/sample-kiro-assistant/main/images/KiroCowork.png)

Task: Can you please review architectures of WAN and SeeDance video models and compare them in a ppt. Add diagrams, screenshots etc. to make your points.
**we added a small animation of Kiro mascot working while the tasks are ongoing to keep you entertained!**

![Kiro Assistant2 UX](https://raw.githubusercontent.com/aws-samples/sample-kiro-assistant/main/images/KiroCowork2.png)

---

If a model works in `kiro-cli`, it works in Kiro Assistant. So for example, if MiniMax M2 can be selected in Kiro CLI, it will work with Kiro Assistant.
Kiro Assistant always uses the model stored in `~/Library/Application Support/kiro-assistant/assistant-settings.json` (managed through the Settings → Default Model dropdown). If you haven’t picked one yet, it falls back to `claude-opus-4.5`. Every prompt launches a fresh `kiro-cli` process using whatever model is currently selected, so changing the dropdown takes effect on the very next run. **Current limitation:** because the conversation metadata is cached by `kiro-cli`, mid-task changes are only picked up after starting a *new task* (which creates a new working directory). If you switch models midway through an existing task, that session will continue using the originally selected model until you spin up another task.

Available models today:

- `claude-opus-4.6` – experimental Claude Opus 4.6
- `claude-opus-4.6-1m` – experimental Opus 4.6 with 1M context
- `claude-opus-4.5`
- `claude-sonnet-4.5` (current default)
- `claude-sonnet-4.5-1m`
- `claude-sonnet-4`
- `claude-haiku-4.5`

Soon to be available more models from Amazon Bedrock (stay tuned)
- `deepseek-3.2`
- `kimi-k2.5`
- `minimax-m2.1`
- `glm-4.7`
- `glm-4.7-flash`
- `qwen3-coder-next`

We highly encourage you to start contributing to the project. 
Kiro-CLI (which wraps Kiro Agents) is awesome. Let us have fun with it.

With new OSS models that will become available soon, you will be able to use Kiro-Assistant as a general AI agent for vast number of tasks every month with your Kiro subscription.

---

## Architecture Overview

The architecture is simple. It trusts models to be resourceful and figure out a way. We use powerful models and give them necessary tools. In a way it is inspired
by the "bitter lesson".

![Kiro Assistant Principle](https://raw.githubusercontent.com/aws-samples/sample-kiro-assistant/main/images/KiroCoworkPrinciple.png)

Agent Cowork - which inspired this project - uses Claude Code CLI which has a SDK called Claude Agents SDK. We can launch Kiro-cli directly from code and receive responses (tool_use requests, responses) through real time SQLite database it maintains.

![Agent Cowork vs Kiro Assistant](https://raw.githubusercontent.com/aws-samples/sample-kiro-assistant/main/images/AgentCoworkvsKiroCoworker.png)

This is a technical diagram of various components involved.

| Layer | Responsibilities | Key Files |
| ----- | ---------------- | --------- |
| **Electron Main** | Boots the BrowserWindow, exposes IPC APIs (`read-file`, `run-kiro-command`, MCP helpers), spawns `kiro-cli chat`, and copies uploads into per-session workspaces. | `src/electron/main.ts`, `src/electron/libs/runner.ts`, `src/electron/libs/mcp-config.ts`, `src/electron/libs/workspace.ts` |
| **React Renderer** | Zustand store + UI components (sessions, prompt bar, MCP settings, file sidebar, file upload). | `src/ui/*` |
| **Kiro CLI runtime** | Talks to models on Amazon Bedrock securely using your Kiro Subscription, executes tools, runs MCP servers, and writes conversation history to its SQLite store. | `/Applications/Kiro CLI.app` or `kiro-cli` on PATH |
| **Persistence** | Assistant metadata/history via `sessions.db`; conversation bodies live in Kiro’s own `~/Library/Application Support/kiro-cli/data.sqlite3`. | `src/electron/libs/session-store.ts` |

More details (mermaid diagrams, SQLite polling strategy, security notes) live in [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) and [`docs/INTEGRATION.md`](docs/INTEGRATION.md).

---

## Installing & Running

### Prerequisites

1. **Kiro CLI** installed and authenticated.
2. **Bun (preferred) or Node.js 18+** for building.
3. **macOS 13+** (the current build targets macOS; Windows/Linux scripts are stubbed but untested).

### Steps

```bash
# Clone from AWS Samples Github
git clone https://github.com/aws-samples/sample-kiro-assistant.git
cd sample-kiro-assistant

# Install dependencies
bun install

# Development mode (Vite + Electron with hot reload)
bun run dev

# Production build (macOS arm64)
bun run dist:mac
```

The macOS bundle is emitted to `dist/mac-arm64/Kiro Assistant.app`. Copy it into `/Applications` (back up any previous version first).
You can also build and run it for Windows machines. Users report it works fine.

```bash
# remove old application
sudo rm -rf "/Applications/Kiro Assistant.app"

# copy the new application to MAC applications
sudo ditto "dist/mac-arm64/Kiro Assistant.app" "/Applications/Kiro Assistant.app"

# You can directly run from command line
open -a "Kiro Assistant"
```

---

## Custom Agent Configuration & MCPs

Kiro Assistant instantiates a custom agent named `kiro-assistant`. Its configuration lives in `~/.kiro/agents/agent_config.json`:
You may use these configurations as they are, just remember to place your keys for Composio (that provides search over 500 MCP tools) and ZAI MCP in respective
Replace_with_your_key field.

```json
{
  "name": "kiro-assistant",
  "description": "A custom agent for my workflow",
  "mcpServers": {
    "pencil": {
      "command": "/Applications/Pencil.app/Contents/Resources/app.asar.unpacked/out/mcp-server-darwin-arm64",
      "args": ["--ws-port", "53881"],
      "env": {},
      "type": "stdio",
      "disabled": false
    },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": ["@playwright/mcp@latest"],
      "env": {},
      "disabled": false
    },
    "composio": {
      "type": "http",
      "url": "https://backend.composio.dev/tool_router/trs_8YCbLt0jkO8_/mcp",
      "headers": {
        "x-api-key": "Replace_with_your_key"
      },
      "disabled": false
    },
    "zai-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@z_ai/mcp-server"],
      "env": {
        "Z_AI_API_KEY": "Replace_with_your_key",
        "Z_AI_MODE": "ZAI"
      },
      "disabled": false
    },
    "excel": {
      "command": "npx",
      "args": ["--yes", "@negokaz/excel-mcp-server"],
      "env": {
        "EXCEL_MCP_PAGING_CELLS_LIMIT": "4000"
      },
      "disabled": false
    }
  },
  "tools": [
    "@pencil","@composio","@playwright","@zai-mcp-server","@excel",
    "read","glob","grep","write","shell","aws","web_search","web_fetch",
    "introspect","report","knowledge","thinking","todo","use_subagent"
  ],
  "allowedTools": [
    "@pencil","@composio","@playwright","@zai-mcp-server","@excel",
    "read","glob","grep","write","shell","aws","web_search","web_fetch",
    "introspect","report","knowledge","thinking","todo","use_subagent"
  ],
  "resources": ["skill:///Users/you/.kiro/skills/**/SKILL.md"],
  "prompt": "You are a general purpose agent you will try your best to complete a tasks with available tools and skills. You will look for files in your workspace also known as working directory. You will create all the files in the same",
  "model": "claude-opus-4.5"
}
```

- During the first launch of the packaged DMG, Kiro Assistant automatically copies a **credential-free** template to `~/.kiro/agents/agent_config.json` so you start with the same MCP/server definitions shown above. You still need to fill in your own API keys for services like Composio or ZAI by editing that file later.
- If you don't want the installer to touch an existing config (e.g., on a dev machine where you copy the app straight into `/Applications`), run `launchctl setenv KIRO_SKIP_AGENT_TEMPLATE 1` before opening the app (clear it with `launchctl unsetenv KIRO_SKIP_AGENT_TEMPLATE`). Only configure the file manually if the automatic setup doesn't occur.
- Edit this file to add/remove MCPs. The Settings dialog simply toggles the `disabled` flag and shows summaries.
- Skills are directories under `~/.kiro/skills`. Each folder is a skill and appears in the UI.
- Adding skills is easy. You can add them by copying folders to the above mentioned path, or you can add them using npx command and selecting Kiro option. They will show up in Settings dialogue.
**`npx skills add remotion-dev/skills`**

![Settings showing MCPs and Skills](https://raw.githubusercontent.com/aws-samples/sample-kiro-assistant/main/images/settings.png)

---

## Working With Files

- **Uploads:** The paperclip copies files into the current workspace (with collision-safe renaming).
- **FileBar:** Separates created vs accessed files; clicking opens them inline (text/images/PDF/Excel) or via the OS.
---

## Troubleshooting Tips

- **Kiro CLI missing:** Ensure `kiro-cli` is installed or set `KIRO_CLI_PATH`.
- **MCP server not showing:** Edit `~/.kiro/agents/agent_config.json` and refresh Settings.
- **Long-running `execute_bash`:** Some commands (e.g., interactive `npx`) block until they finish. You can ask Kiro Assistant to run them without user input.
- **`better-sqlite3` ABI mismatch:** If you see `...better_sqlite3.node was compiled against NODE_MODULE_VERSION 137... requires NODE_MODULE_VERSION 140`, run `npx electron-rebuild -f -w better-sqlite3` to rebuild the native module against the Electron ABI you have installed.
---

## Sample Applications

1. Audio creation
2. Video creation
3. Excel modelling
4. Helping cancel unwanted subscriptions
5. Social media management
6. Daily tasks (emails, scheduling)

### Converting articles to audio and video podcasts, great for making training videos (click on the image)
You can give it article that you don't have time to read. It can convert them to audio podcasts.

You can even ask it do research for you and make the output into podcasts so you can listen while doing mundane activities.
For example, here it is making a podcast for me on Moltbot controversy. It 1/ did the research, 2/ wrote a script, 3/ produced audio using ElevenLabs (MP3), 
4/ produced a poster, 5/ stitched together the poster and MP3 to produce MP4 using FFMPEG.

Just listen and remember this is all being orchestrated autonomously by Kiro-CLI. I did not have to do anything.

If you want to record a training video, you can give it text and it will make a perfectly edited video for you. It will figure out services to use and deliver the final outcome.
You may need to give feedback sometimes (off-coures).

### Designing creatives with Pencil Desktop

If you want a beautiful poster, creative etc. it can use Pencil MCP and create well thought out creatives for you.

![Pencil Desktop](https://raw.githubusercontent.com/aws-samples/sample-kiro-assistant/main/images/Pencil_Desktop.png)

### Research and Excel Modelling Example

Here we asked Kiro-Assistant to study impact of AI boom on stocks on MAG7 companies and prominent SaaS stocks.
It got this data from reputable sources.

![Excel Modelling Step 1](https://raw.githubusercontent.com/aws-samples/sample-kiro-assistant/main/images/excel1.png)

It didn't just build great tables, it also built great meaningful visualizations.

![Excel Modelling Step 2](https://raw.githubusercontent.com/aws-samples/sample-kiro-assistant/main/images/excel2.png)

---

### Research & Power point presentations

We asked Kiro-Assitant to study architecture of WAN and SeeDance 1 video models and create a presentation to compare and contrast them.

It got this data from reputable sources.

![Power Point](https://raw.githubusercontent.com/aws-samples/sample-kiro-assistant/main/images/Kiro_ppt.png)

---

### Product Video Creation Example (click on the image)

It has many skills for PPTs, Excel, Videos etc. Here is a simple promotional video it made using Remotion-Best-Practices skill.

---

## Contributing

1. Fork or clone `https://github.com/aws-samples/sample-kiro-assistant.git`.
2. Run `bun run dev` for iterative changes.
3. Update docs when touching architecture or UX.
4. Open a pull request with a clear summary and testing notes.
---

## Roadmap

1. Add voice interface
2. Add support for MCP for Apps for interactive applications with this desktop interface.
3. Integrate Kiro CLI with help of Kiro SDK once it is released (due soon), replacing current arrangement of getting Kiro-CLI responses through SQLite database.
4. Social connections - slack, Whatsapp, Telegram, iMessage
5. 24*7 running agents in the cloud - designed for cost effectiveness and security.
---

## License

The project started with this base [Agent Cowork](https://github.com/DevAgentForge/Claude-Cowork) which is under MIT license. This project is also released under MIT. Kiro-CLI that provides Kiro Agent for this project is an Amazon Web Services product (all right reserved).

---

## Comments on security

It runs on local machine, and accesses files from working directories. It access models on Bedrock through Kiro-CLI. It is no different from using Kiro-CLI. It calls external APIs with users’ own account (OAuth). These are the services that users already trust. There is a proper login flow that helps user log in into services like ElevanLabs, HeyGen, Gmail etc. Use Composio Search tool and SaaS services it avails, if you trust them. We DO NOT assume responsibility for any loss arising out of use of this prototype.

Local MCPs like excel, playwright don’t need credentials. We also use ZAI MCPs for dealing with PDFs, Images etc. It gets automatically used if the model being used is not multimodal. User can remove any of the MCPs they don’t prefer.

**Typical advisory applicable for any GenAI service applies to this one.**

sample-kiro-assistant

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README