{"_id":"@aliceljy/agent-nexus","name":"@aliceljy/agent-nexus","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@aliceljy/agent-nexus","version":"0.1.0","description":"One-click installer for RecallNest + telegram-ai-bridge. Shared memory + TG remote for CC/Codex/Gemini.","license":"MIT","type":"module","bin":{"agent-nexus":"bin/agent-nexus.ts"},"dependencies":{"recallnest":"^1.4.1","telegram-ai-bridge":"^2.2.0"},"engines":{"bun":">=1.3.0"},"repository":{"type":"git","url":"git+https://github.com/AliceLJY/agent-nexus.git"},"gitHead":"cc7d156a73b23c0e7a5d5b376dd41f6aa64a162c","_id":"@aliceljy/agent-nexus@0.1.0","bugs":{"url":"https://github.com/AliceLJY/agent-nexus/issues"},"homepage":"https://github.com/AliceLJY/agent-nexus#readme","_nodeVersion":"25.2.1","_npmVersion":"11.6.2","dist":{"integrity":"sha512-9i0XNNsEqSb5dmqjlxqhdddI4RthMw/N5AS8wYcQBPQWASqfghYCEOH8uyXcIKk1pP0hcS/7y7iom2hgTw4R+g==","shasum":"c7888826532cbf5eb5c73a1219f8b9315072db04","tarball":"https://registry.npmjs.org/@aliceljy/agent-nexus/-/agent-nexus-0.1.0.tgz","fileCount":14,"unpackedSize":59710,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAFrfTfZ0hgmHt9ND764vhqrTAe3sC11wuXl+BfIpP+WAiEAtTKErU9i0D4X5bJHMiVEvipglyu1g0vDxtkUzqPqEtM="}]},"_npmUser":{"name":"aliceljy","email":"lijingya1210@gmail.com"},"directories":{},"maintainers":[{"name":"aliceljy","email":"lijingya1210@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agent-nexus_0.1.0_1775039789012_0.7099837986074318"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-01T10:36:28.895Z","0.1.0":"2026-04-01T10:36:29.164Z","modified":"2026-04-01T10:36:29.384Z"},"maintainers":[{"name":"aliceljy","email":"lijingya1210@gmail.com"}],"description":"One-click installer for RecallNest + telegram-ai-bridge. Shared memory + TG remote for CC/Codex/Gemini.","homepage":"https://github.com/AliceLJY/agent-nexus#readme","repository":{"type":"git","url":"git+https://github.com/AliceLJY/agent-nexus.git"},"bugs":{"url":"https://github.com/AliceLJY/agent-nexus/issues"},"license":"MIT","readme":"<div align=\"center\">\n\n# agent-nexus\n\n**One Command. All Your AI Agents United.**\n\n*Shared memory + Telegram remote control for Claude Code, Codex, and Gemini CLI -- installed in 60 seconds.*\n\n[![MIT License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Bun](https://img.shields.io/badge/Runtime-Bun-f9f1e1?logo=bun)](https://bun.sh)\n[![npm version](https://img.shields.io/npm/v/@aliceljy/agent-nexus)](https://www.npmjs.com/package/@aliceljy/agent-nexus)\n\n**English** | [简体中文](README_CN.md)\n\n</div>\n\n---\n\n## The Problem\n\nYou have Claude Code, Codex, maybe Gemini CLI. They're powerful individually. But right now:\n\n- **They don't share memory.** Tell Claude your coding style, Codex has no idea.\n- **They can't be controlled remotely.** Step away from your desk? Your agents are unreachable.\n- **Setting up shared infrastructure is painful.** Clone this, configure that, edit three different config files...\n\nYou *could* spend an afternoon installing [RecallNest](https://github.com/AliceLJY/recallnest) for shared memory, [telegram-ai-bridge](https://github.com/AliceLJY/telegram-ai-bridge) for remote control, and manually wiring MCP configs for each tool.\n\nOr:\n\n```bash\nnpm i -g @aliceljy/agent-nexus && agent-nexus init\n```\n\n## What Happens When You Run `init`\n\n```\n$ agent-nexus init\n\n  Detecting environment...\n  ✅ Bun\n  ✅ Claude Code\n  ✅ Codex CLI\n  ⬚ Gemini CLI (not installed, skipping)\n\n  📝 Credentials\n\n  Telegram Bot Token: ********\n  Your Telegram User ID: 123456\n  Jina API Key: jina_****\n\n  🔌 Configuring MCP...\n\n  📋 Backed up ~/.claude.json\n  ✅ Claude Code MCP configured\n  ✅ Codex MCP configured\n  ✅ Bridge config generated\n\n  ✅ agent-nexus setup complete!\n  Run: agent-nexus start\n```\n\n**That's it.** Your Claude Code and Codex now share one brain. Your phone is now the remote.\n\n## Before / After\n\n| | Before agent-nexus | After agent-nexus |\n|---|---|---|\n| **Memory** | Each agent starts from zero every session | All agents share persistent memory via RecallNest |\n| **Remote control** | Must be at your desk | Full control from Telegram on your phone |\n| **Setup time** | 30+ min (clone, configure, debug MCP paths...) | 60 seconds |\n| **Config files to edit** | 3-5 (per tool, per service) | 0 (auto-injected) |\n| **Processes to manage** | Start each service manually | `agent-nexus start` / `stop` |\n\n## Install\n\n```bash\nnpm i -g @aliceljy/agent-nexus\n```\n\n> Requires [Bun](https://bun.sh) >= 1.3 and at least one of: Claude Code, Codex CLI, or Gemini CLI.\n\n## Usage\n\n```bash\nagent-nexus init      # Interactive wizard -- detects tools, collects keys, writes all configs\nagent-nexus start     # Start RecallNest + Telegram bridge in background\nagent-nexus stop      # Stop all services\nagent-nexus status    # Health check with memory stats\n```\n\n## How It Works\n\n```\n                    agent-nexus init\n                         |\n          +--------------+--------------+\n          |              |              |\n     ~/.claude.json  ~/.codex/     ~/.gemini/\n     (MCP injected)  config.toml   settings.json\n          |              |              |\n          v              v              v\n     Claude Code     Codex CLI    Gemini CLI\n          |              |              |\n          +------+-------+------+------+\n                 |              |\n            RecallNest    telegram-ai-bridge\n            (memory)      (remote control)\n                 |              |\n            LanceDB         Telegram\n          (your brain)    (your phone)\n```\n\n**agent-nexus doesn't replace anything.** It's the glue that makes your existing tools work as a team.\n\n## What Gets Installed\n\n| Component | What It Does | Already Have It? |\n|-----------|-------------|-----------------|\n| [RecallNest](https://github.com/AliceLJY/recallnest) | Shared memory across all agents (MCP + HTTP API) | Keeps yours, adds if missing |\n| [telegram-ai-bridge](https://github.com/AliceLJY/telegram-ai-bridge) | Telegram remote control for AI agents | Keeps yours, adds if missing |\n| MCP configs | RecallNest auto-registered in each tool | Non-destructive merge (backup first) |\n\n## Prerequisites\n\n- [Bun](https://bun.sh) >= 1.3\n- At least one AI CLI tool:\n  - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) \n  - [Codex CLI](https://github.com/openai/codex) \n  - [Gemini CLI](https://github.com/google-gemini/gemini-cli)\n- A Telegram bot token (free, from [@BotFather](https://t.me/BotFather))\n- A Jina API key (free tier available at [jina.ai](https://jina.ai))\n\n## Config\n\nAll configuration lives in one place: `~/.agent-nexus/config.json`\n\n```jsonc\n{\n  \"telegram\": { \"botToken\": \"...\", \"ownerId\": 123456 },\n  \"memory\": { \"jinaApiKey\": \"...\", \"dbPath\": \"~/.recallnest/data/lancedb\" },\n  \"agents\": { \"claude\": true, \"codex\": true, \"gemini\": false }\n}\n```\n\n## Ecosystem\n\nagent-nexus is the installer for a larger ecosystem of AI agent tools:\n\n| Project | Role | Stars |\n|---------|------|-------|\n| [RecallNest](https://github.com/AliceLJY/recallnest) | Shared memory layer (LanceDB + hybrid retrieval) | ![GitHub stars](https://img.shields.io/github/stars/AliceLJY/recallnest) |\n| [telegram-ai-bridge](https://github.com/AliceLJY/telegram-ai-bridge) | Telegram remote control + multi-agent orchestration | ![GitHub stars](https://img.shields.io/github/stars/AliceLJY/telegram-ai-bridge) |\n| [Claude Code Studio](https://github.com/AliceLJY/claude-code-studio) | Multi-session collaboration platform for Claude Code | ![GitHub stars](https://img.shields.io/github/stars/AliceLJY/claude-code-studio) |\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-f5d3fd1e89830ebce5b8fe73dc017282"}