AgentNest
Junpeiwada/AgentNest
Web UI remota para Claude Code com suporte mobile e gerenciador de arquivos
Ver no GitHubInterface web para operacionalizar Claude Code em qualquer navegador, incluindo mobile. Permite executar operações de desenvolvimento (CLI, git, alterações de código) remotamente via servidor Express com streaming SSE, incluindo gerenciador de arquivos integrado.
Instalação
npx convez-ai Junpeiwada/AgentNest1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Desenvolvimento remoto via iPhone ou notebook sem ambiente local
- Execução de operações git e deploy remotos
- Geração automática de documentação e especificações a partir de código
Veredito

Solução bem-arquitetada para operacionalizar Claude Code remotamente com UI otimizada para mobile. Exige pré-requisitos (Claude CLI, Max subscription) e conhecimento técnico, mas entrega valor real para desenvolvimento distribuído e automação de tarefas.
README
A tradução para o português deste README ainda está na fila.
AgentNest
ブラウザから Claude Code を操作する Web インターフェース。
開発マシンで起動したサーバに外部からアクセスすることで、iPhone や別の PC のブラウザからリモートの開発マシン上の Claude Code を遠隔操作できます。
Claude Code を介して CLI コマンドの実行や git 操作なども行えるため、 手元に開発環境がなくても外出先からコードの修正・コミット・デプロイといった開発作業が可能です。
ファイルブラウザも内蔵しており、リモートマシン上のコードや画像をブラウザ上で直接閲覧できます。 Tailscale などの VPN 経由でアクセスすれば、ポートをインターネットに公開せず安全に利用できます。
特徴
- チャット UI — Claude Code とリアルタイム対話(SSE ストリーミング)
- リポジトリ選択 — 複数プロジェクトを切り替えて操作
- ファイルブラウザ — コード・Markdown・画像をブラウザ上でプレビュー
- 画像添付 — ペースト / ドラッグ&ドロップで画像を送信
- 権限管理 — ファイル書き込み等の操作を承認/拒否するダイアログ
- セッション管理 — 会話履歴の保存・再開
- iPhone 最適化 — キーボード検出・セーフエリア対応のレスポンシブ UI
技術スタック
| レイヤー | 技術 |
|---|---|
| フロントエンド | React 19 + Vite + MUI |
| バックエンド | Express.js + TypeScript |
| AI エンジン | Claude Agent SDK (@anthropic-ai/claude-agent-sdk) |
| リアルタイム通信 | Server-Sent Events (SSE) |
| テスト | Playwright |
インストール
前提: Claude Code CLI のインストール
AgentNest は Claude Code CLI(claude)を同梱していません。実行時にユーザー環境の claude を利用するため、事前にインストールしておく必要があります(未インストールだとチャットが動作しません)。
公式インストール手順 に従って導入してください。~/.local/bin/claude・Homebrew(/opt/homebrew/bin・/usr/local/bin)・PATH 上の claude を自動探索します。別の場所にある場合は .env の CLAUDE_CLI_PATH で実行ファイルのパスを明示できます。
GitHub Releases からインストール(macOS)
Releases から DMG をダウンロードしてインストールできます。ユニバーサルバイナリのため、Apple Silicon・Intel どちらの Mac でも動作します。
Apple Developer 署名がないため、初回起動時に「壊れている」と表示されます。以下のコマンドで解除してください:
xattr -cr /Applications/AgentNest.app
インストール後はアプリ内の「更新を確認」ボタンで自動更新できます(2回目以降はこの操作は不要です)。
セットアップ
npm install
cd frontend && npm install && cd ..
cp .env.example .env
# .env を編集して BASE_PROJECT_DIR にプロジェクトディレクトリのパスを設定
使い方
開発モード
npm run dev
サーバ(port 3000)とフロントエンド(port 5173)が同時に起動します。
プロダクション
npm run build
npm start
テスト
npm test # Playwright E2E テスト
npm run test:ui # Playwright UI モード
想定ユースケース
- ブログ記事投稿 — iPhone から写真 URL を送り、記事を生成・公開
- 仕様書生成 — コードや DB 定義から画面仕様書を自動生成
- 汎用開発 — 任意のリポジトリに対して Claude Code を実行
利用環境
ローカルマシン(macOS)でサーバを起動し、Tailscale VPN 経由で外部からアクセスする構成を想定しています。Claude Code の Max サブスクリプションが必要です。
プロジェクト構成
AgentNest/
├── frontend/ # React + Vite UI
│ └── src/
│ ├── components/ # Chat, FileExplorer, Header, etc.
│ └── hooks/ # useChat (SSE + state管理)
├── server/ # Express API
│ ├── routes/ # chat, repos, sessions, files, permission
│ └── claude/ # Claude Code SDK ラッパー
├── tests/ # Playwright E2E テスト
└── Docs/ # 仕様書・設計ドキュメント