Nagi (凪)

面倒な作業やノイズを静かに消し去り、日常に波風の立たない「凪」のような平穏をもたらす。
表立って主張するのではなく、裏で動いて平和を保ってくれる相棒。

AI assistant that runs Claude Agent SDK in Docker containers and communicates through messaging channels (Slack, Discord, Asana, etc.).

Slack, Discord, Asana のいずれかにメッセージを送ると、Docker コンテナ内で Claude がコードを書いたりブラウザを操作したりしてくれる — 個人用の AI エージェント基盤です。

Built as a clean-room reimplementation of NanoClaw with a Turborepo monorepo architecture, plugin system, and DI-based design.

Example

Send @ai ai changelog in Slack and Claude pulls the week's release notes from each AI provider inside the container, deploys a summary site to Vercel, and replies with the URL — all in the same thread. Tool calls, cost, and token usage are surfaced inline for visibility.

Deployed output: https://ai-changelog-66qx26i5e-yukihirops-projects.vercel.app

Prerequisites

• Docker (required — agents run in containers)
• Node.js >= 22
• pnpm >= 9
• Claude Code (setup is driven by Claude Code skills)

Quick Start

git clone https://github.com/yukihirop/nagi.git
cd nagi
claude

Open Claude Code in this directory and run:

/setup

Channels

Nagi responds to @ai (or your configured assistant name) in:

• Slack — Socket Mode, no public URL needed. /add-channel-slack
• Discord — Gateway intents with a bot token. /add-channel-discord
• Asana — Polls task comments for @ai triggers, replies on an auto-created subtask so the parent task stays clean. Also grounds each reply with the task's name, description and comment history as context. /add-channel-asana

CLI

Run agents from the terminal without opening Slack:

pnpm nagi "今日の天気を教えて"
pnpm nagi --list

Dashboard UI

Web-based dashboard for monitoring and reviewing agent activity:

pnpm ui:dev    # Start SPA (port 5174) + API server (port 3001)

• Overview — Stat cards for Groups, Channels, Tasks, Sessions, and Logs
• Groups / Channels — Registered groups and channel connection status
• Sessions — Browse agent conversation logs in a chat UI with expandable thinking and tool use timelines
• Tasks — Scheduled task list
• Logs — Container and task execution logs with type filter
• Settings — Dark / light theme toggle

Tech: React 19 + Tailwind CSS 4 + Vite + Hono

Architecture

See docs/architecture.md

Troubleshooting

Just ask Claude Code. It understands the codebase and skills, and can fix most issues for you.

Uninstall

Run /teardown in Claude Code to stop the service and remove the assistant.