{"_id":"@9octopus/9octopus-cli","name":"@9octopus/9octopus-cli","dist-tags":{"latest":"0.2.0"},"versions":{"0.2.0":{"name":"@9octopus/9octopus-cli","version":"0.2.0","description":"A powerful, open-source AI coding agent for your terminal. Connect directly to LLMs or use our backend service.","keywords":["ai","cli","agent","llm","openai","anthropic","google","gemini","grok","langchain","langgraph","coding-assistant","terminal"],"homepage":"https://github.com/9OctopusDev/9octopus-cli-oss#readme","bugs":{"url":"https://github.com/9OctopusDev/9octopus-cli-oss/issues"},"repository":{"type":"git","url":"git+https://github.com/9OctopusDev/9octopus-cli-oss.git"},"license":"MIT","bin":{"9octopus-cli":"dist/cli.js"},"type":"module","engines":{"node":">=16"},"scripts":{"build":"tsc && node scripts/inject-env.js","dev":"tsc --watch","check":"prettier --check","lint":"xo","test":"npx ava","fix":"prettier --write"},"dependencies":{"@auth0/auth0-spa-js":"^2.4.1","@inkkit/ink-markdown":"^1.0.0","@langchain/anthropic":"^1.1.3","@langchain/core":"^1.1.0","@langchain/google-genai":"^2.0.1","@langchain/groq":"^1.0.2","@langchain/langgraph":"^1.0.2","@langchain/openai":"^1.1.3","@types/eventsource":"^1.1.15","cli-spinners":"^3.2.0","dedent":"^1.6.0","eventsource":"^4.0.0","find-up":"^8.0.0","ink":"^6.5.1","ink-markdown":"^1.0.4","ink-select-input":"^6.2.0","ink-spinner":"^5.0.0","ink-task-list":"^2.0.0","ink-text-input":"^6.0.0","js-yaml":"^4.1.0","keytar":"^7.9.0","marked":"^9.1.6","marked-terminal":"^7.3.0","meow":"^11.0.0","node-fetch":"^3.3.2","open":"^10.2.0","react":"^19.0.2","uuid":"^13.0.0"},"devDependencies":{"@sindresorhus/tsconfig":"^3.0.1","@types/react":"^19.0.2","@vdemedes/prettier-config":"^2.0.1","ava":"^5.2.0","chalk":"^5.2.0","dotenv":"^17.2.3","eslint-config-xo-react":"^0.27.0","eslint-plugin-react":"^7.32.2","eslint-plugin-react-hooks":"^4.6.0","ink-testing-library":"^3.0.0","prettier":"^2.8.7","replace-in-file":"^8.3.0","ts-node":"^10.9.1","typescript":"^5.0.3","xo":"^0.53.1"},"ava":{"files":["dist/test/**/*.test.js"]},"xo":{"extends":"xo-react","prettier":true,"rules":{"react/prop-types":"off","unicorn/expiring-todo-comments":"off"},"ignores":["scripts/**","test-ts-node.ts"]},"prettier":"@vdemedes/prettier-config","_id":"@9octopus/9octopus-cli@0.2.0","gitHead":"0b0fb9bfbf9435617a1ff77511f7d4a3c59dc385","_nodeVersion":"20.19.6","_npmVersion":"10.8.2","dist":{"integrity":"sha512-1mzvCkVoFoCQ6tUKIqcbf96Cx/rtHoTaSlzBj69jf+F4sLpDynHJiPofaUC88+EmFthkPImHh2umLx4sA4dURw==","shasum":"849a01de03b7b403b0b53ec0eb6e84a4bff73d5e","tarball":"https://registry.npmjs.org/@9octopus/9octopus-cli/-/9octopus-cli-0.2.0.tgz","fileCount":139,"unpackedSize":357330,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCdzfUOAIUF7KqHJx7irTIz0zvvQSaKJ45SOG9n1D0XOQIgGiL9J5fH8/WAE/xTYCzzN7jSZOvMxs1GEc98RHbapao="}]},"_npmUser":{"name":"9octopus","email":"hello@9octopus.com"},"directories":{},"maintainers":[{"name":"9octopus","email":"hello@9octopus.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/9octopus-cli_0.2.0_1765369117717_0.21452275456055947"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-10T12:18:37.614Z","0.2.0":"2025-12-10T12:18:37.878Z","modified":"2025-12-10T12:18:38.179Z"},"maintainers":[{"name":"9octopus","email":"hello@9octopus.com"}],"description":"A powerful, open-source AI coding agent for your terminal. Connect directly to LLMs or use our backend service.","homepage":"https://github.com/9OctopusDev/9octopus-cli-oss#readme","keywords":["ai","cli","agent","llm","openai","anthropic","google","gemini","grok","langchain","langgraph","coding-assistant","terminal"],"repository":{"type":"git","url":"git+https://github.com/9OctopusDev/9octopus-cli-oss.git"},"bugs":{"url":"https://github.com/9OctopusDev/9octopus-cli-oss/issues"},"license":"MIT","readme":"# 9Octopus CLI - The AI Coding Agent for Your Terminal\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue.svg)](https://www.typescriptlang.org/)\n[![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg)]()\n\n**9Octopus CLI** is a powerful, open-source AI coding agent that lives in your terminal. It empowers developers to interact with Large Language Models (LLMs) directly from the command line, enabling seamless coding assistance, file manipulation, and system automation.\n\nWhether you want to use our backend service or connect directly to your favorite LLM provider (OpenAI, Anthropic) with your own API keys, 9Octopus gives you the flexibility and power you need.\n\n## 🚀 Key Features\n\n- **🤖 AI Agent in Your Terminal**: Chat with advanced LLMs without leaving your workflow.\n- **🔌 Direct LLM Connection (BYOK)**: Connect directly to OpenAI or Anthropic using your own API keys. No middleman required.\n- **🛠️ Tool Integration**: The agent can read files, write code, run shell commands, and search your codebase.\n- **🧠 Custom System Prompts**: Tailor the agent's personality and capabilities with a `9octopus.system.md` file.\n- **🔒 Privacy First**: In Direct Mode, your data goes straight to the LLM provider.\n- **⚡ LangGraph Powered**: Built on the robust LangGraph framework for reliable agentic workflows.\n\n## 📦 Installation\n\n```bash\nnpm install --global @9octopus/9octopus-cli\n```\n\n## 🛠️ Usage\n\n### 1. Configuration\n\nBefore you start, you can configure your preferred model and provider.\n\n**Direct Mode (Recommended for Developers)**\nTo use 9Octopus with your own API keys, simply set the environment variables:\n\n```bash\nexport 9OCTOPUS_SERVICE=false\nexport OPENAI_API_KEY=your_openai_key\n# OR\nexport ANTHROPIC_API_KEY=your_anthropic_key\nexport GOOGLE_API_KEY=your_google_api_key\nexport GROK_API_KEY=your_grok_api_key\n```\n\n### 2. Basic Commands\n\nStart the interactive chat session:\n\n```bash\n9octopus-cli\n```\n\n### 3. In-Chat Commands\n\nOnce inside the CLI, you can use slash commands to control the agent:\n\n- `/models`: List and manage available models.\n- `/clear`: Clear the conversation history.\n- `/help`: Show available commands.\n- `/exit`: Exit the CLI.\n\n### 4. Custom System Prompt\n\nWant to customize how 9Octopus behaves? Create a `9octopus.system.md` file in your project root. The agent will read this file and use it as its system prompt.\n\n```markdown\n# 9octopus.system.md\n\nYou are a senior React developer. Always prefer functional components and hooks.\n```\n\n## 🏗️ Architecture\n\n9Octopus is built with a modular architecture:\n\n- **Core**: Handles API communication, session management, and tool execution.\n- **UI**: Built with [Ink](https://github.com/vadimdemedes/ink) for a rich terminal user interface.\n- **Agent**: Powered by [LangGraph](https://langchain-ai.github.io/langgraph/) to manage conversation state and tool usage.\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to get started.\n\n## 📜 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n<p align=\"center\">\n  Made with ❤️ by the 9Octopus Team\n</p>\n","readmeFilename":"readme.md","_rev":"1-3e99aed947ed9842f892a6a320105047"}