Repository navigation
Home
Cloud-Driven · Local-Executing · Autonomous Agent
云端驱动 · 本地执行 · 自主智能体
CogitoAgent is a cloud-driven, locally executing autonomous AI agent. It connects to cloud-based large language models (LLMs) for reasoning, while safely performing file operations, code execution, web browsing, database queries, and more on your local machine. It is both an intelligent assistant and an extensible tool execution platform.
CogitoAgent 是一个云端驱动、本地执行的自主 AI 智能体。它连接云端大语言模型进行推理,在本地安全地执行文件操作、代码运行、网页浏览、数据库查询等实际操作。它既是一个智能助手,也是一个可扩展的工具执行平台。
CogitoAgent employs an Observe-Think-Act iterative paradigm. In each cycle, it perceives input, builds prompts, invokes the LLM, parses responses, executes tools, and decides the next action—whether to continue thinking, execute more tools, or deliver the final answer. This mechanism enables the agent to autonomously complete complex multi-step tasks.
CogitoAgent 采用观察-思考-行动的迭代范式。每一轮循环中,它会感知输入、构建提示、调用 LLM、解析响应、执行工具,并决定下一步行动——是继续思考、执行更多工具,还是输出最终答案。这种机制让 Agent 能够自主完成复杂的多步骤任务。
CogitoAgent ships with over 200 built-in tools organized into 20 categories: file operations, code execution, Git version control, browser automation, database queries, data processing, system monitoring, geographic information systems (GIS), life sciences, medicine, chemistry, finance, mathematics, and more. Each tool follows a unified registration and calling interface, making them easy to use and extend.
CogitoAgent 内置了 200 多个工具,分为 20 个类别:文件操作、代码执行、Git 版本控制、浏览器自动化、数据库查询、数据处理、系统监控、地理信息、生命科学、医学、化学、金融、数学等。每个工具都遵循统一的注册和调用接口,使用和扩展都非常方便。
All code execution runs in an isolated sandbox environment. JavaScript executes in a separate V8 Isolate via isolated-vm with memory limits and CPU timeouts. Python runs in temporary files with cleaned environment variables. Dangerous operations require user confirmation by default. Your system stays safe.
所有代码执行都在隔离的沙箱环境中运行。JavaScript 通过 isolated-vm 在独立的 V8 Isolate 中执行,带有内存限制和 CPU 超时保护。Python 在临时文件中运行,环境变量经过清理。危险操作默认需要用户确认。你的系统始终保持安全。
Each conversation runs in an independent session with its own history and context. Sessions persist to disk, support automatic compression when token limits are reached, and can be switched, renamed, or deleted at any time. Your conversations are always organized and under your control.
每次对话都在独立的会话中运行,拥有自己的历史和上下文。会话持久化存储到磁盘,达到 Token 限制时自动压缩,你可以随时切换、重命名或删除会话。你的对话始终保持有序,尽在掌控。
CogitoAgent can spawn sub-agents to delegate tasks, enabling multi-agent collaboration. You can create specialized agents with different personas and have them work in parallel, participate in panel discussions, or run in pipelines where one agent's output becomes the next agent's input.
CogitoAgent 可以生成子智能体来委派任务,实现多智能体协作。你可以创建具有不同人设的专用 Agent,让它们并行工作、参与圆桌讨论,或组成流水线——前一个 Agent 的输出自动成为下一个 Agent 的输入。
CogitoAgent connects to WeChat via the iLink protocol, allowing you to receive and reply to WeChat messages through the agent. Messages are stored in a dedicated WeChat session, displayed as tool call cards, and the login state persists across restarts. Your WeChat contacts can interact with your agent seamlessly.
CogitoAgent 通过 iLink 协议连接微信,让你可以通过 Agent 接收和回复微信消息。消息存储在独立的微信专属会话中,以工具调用卡片样式展示,登录状态在重启后依然保持。你的微信好友可以无缝地与你的 Agent 互动。
You can extend CogitoAgent with custom tools via the plugin system. Drop a plugin into the plugins/ directory, and it loads automatically. Plugins follow a simple index.js format and can register any number of tools with custom logic.
你可以通过插件系统为 CogitoAgent 扩展自定义工具。将插件放入 plugins/ 目录即可自动加载。插件遵循简单的 index.js 格式,可以注册任意数量的自定义工具。
The built-in monitoring dashboard provides real-time visualization of thought traces, tool usage statistics, and cluster topology. It runs as an independent Electron window and updates live via WebSocket, giving you full visibility into what your agent is doing at all times.
内置的监控面板提供思维链、工具使用统计和集群拓扑的实时可视化。它作为独立的 Electron 窗口运行,通过 WebSocket 实时更新,让你随时全面了解 Agent 的一举一动。
| English | 中文 |
|---|---|
| Installation | 安装指南 |
| Quick Start | 快速上手 |
| Configuration | 配置说明 |
| Architecture Overview | 架构设计 |
| Tools | 工具列表 |
| Deployment | 部署指南 |
| FAQ | 常见问题 |
| Layer | Technology |
|---|---|
| Runtime | Node.js 20+ |
| Desktop Framework | Electron |
| Language | TypeScript / JavaScript |
| Real-Time Communication | WebSocket (ws) |
| Code Isolation | isolated-vm / Node.js vm |
| Browser Automation | Playwright |
| Database | SQLite (sql.js) |
| Containerization | Docker / Docker Compose |
cogito-agent/
├── src/ # Agent core engine
│ ├── agent/ # Agent logic, tools, session management
│ ├── api/ # LLM client, model management
│ ├── io/ # Terminal, logging, WebSocket server
│ └── types/ # TypeScript type definitions
├── electron/ # Electron desktop application
│ ├── desktop/ # Desktop pet mode
│ ├── dashboard/ # Dashboard mode
│ ├── monitor/ # Monitoring panel
│ └── setup/ # Configuration wizard
├── personas/ # Preset personas
├── data/ # Runtime data (sessions, memory, logs)
├── plugins/ # Plugin directory
└── docs/ # Documentation
Apache License 2.0
Next: Installation →
下一步: 安装指南 →