@soloco/cli 0.3.1-canary.0

package/LICENSE

@@ -0,0 +1,61 @@
+Soloco — Proprietary Software License
+Copyright (c) 2026 Soloco AI. All rights reserved.
+
+This software (the "Software") is proprietary to Soloco AI. By downloading,
+installing, or using the Software you agree to the terms below. If you do not
+agree, do not use the Software.
+
+1. GRANT OF LICENSE
+   Subject to the restrictions below, Soloco AI grants you a personal,
+   non-exclusive, non-transferable, revocable license to install and run the
+   Software on machines you own or control, for your own internal use only.
+
+2. RESTRICTIONS
+   You shall not, and shall not permit any third party to:
+     (a) copy, modify, translate, or create derivative works of the Software,
+         except as strictly necessary to install and run it for your own
+         internal use;
+     (b) distribute, sublicense, lease, rent, sell, or otherwise transfer the
+         Software or access to the Software to any third party;
+     (c) reverse engineer, decompile, or disassemble the Software, except to
+         the extent applicable law expressly permits despite this restriction;
+     (d) remove or alter any proprietary notices, labels, or marks on the
+         Software;
+     (e) use the Software to provide a hosted, managed, or "as-a-service"
+         offering to third parties;
+     (f) use the Software in violation of any applicable law.
+
+3. THIRD-PARTY COMPONENTS
+   The Software incorporates open-source components, including parts derived
+   from the Paperclip framework. Those components remain governed by their
+   own licenses, copies of which are reproduced in the NOTICE file. Nothing in
+   this License affects your rights under those open-source licenses with
+   respect to the open-source components themselves.
+
+4. INTELLECTUAL PROPERTY
+   The Software is licensed, not sold. Soloco AI retains all right, title, and
+   interest in and to the Software, including all intellectual property rights.
+   No rights are granted to you other than those expressly stated in this
+   License.
+
+5. TERMINATION
+   This License is effective until terminated. It will terminate automatically
+   if you fail to comply with any term. Upon termination you must stop using
+   the Software and destroy all copies in your possession.
+
+6. NO WARRANTY
+   THE SOFTWARE IS PROVIDED "AS IS" AND "AS AVAILABLE", WITHOUT WARRANTY OF
+   ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+   OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+
+7. LIMITATION OF LIABILITY
+   TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, SOLOCO AI SHALL NOT BE
+   LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, OR PUNITIVE
+   DAMAGES, OR ANY LOSS OF PROFITS OR REVENUES, ARISING OUT OF OR RELATING TO
+   YOUR USE OF OR INABILITY TO USE THE SOFTWARE.
+
+8. GOVERNING LAW
+   This License is governed by the laws of the People's Republic of China,
+   without regard to conflict-of-laws rules.
+
+For licensing inquiries: contact Soloco AI.

package/README.md

@@ -0,0 +1,116 @@
+# Soloco
+
+> **专有软件 / Proprietary** — Copyright © 2026 Soloco AI. All rights reserved.
+> 仅个人/获授权用户运行使用，**不得分发、转售、反编译、提供 SaaS**。
+> 完整条款见 [LICENSE](./LICENSE)；第三方开源依赖与上游 attribution 见 [NOTICE](./NOTICE)。
+
+围绕你给定的 **goal**，Soloco 会自动拆分阶段、派出多个 agent、循环执行直到完成——
+所有动作发生在你本机，使用你自己的 Claude 订阅，产物落在你能直接打开的目录里。
+
+---
+
+## 5 分钟跑起来
+
+### 前提
+
+- **Node.js ≥ 20**（[下载](https://nodejs.org/)）
+- **pnpm 9+** （`npm install -g pnpm`）
+- **Anthropic API key** （[去 Console 拿一个](https://console.anthropic.com/settings/keys)，建议先设月度预算上限）
+
+### 步骤
+
+```bash
+# 1. clone
+git clone <repo-url> soloco
+cd soloco
+
+# 2. 装依赖
+pnpm install
+
+# 3. 配 API key
+cp .env.example .env
+# 用编辑器打开 .env，把 ANTHROPIC_API_KEY=sk-ant-... 这行的 sk-ant-... 替换成你的真 key
+# 同时把这份 .env 也复制到 server/ 目录下（server 直接读 server/.env）
+cp .env server/.env
+
+# 4. 启动
+pnpm dev
+```
+
+终端看到 `Server listening on 0.0.0.0:3100` + `VITE ready` 之后就可以用了。
+
+**浏览器打开 → http://localhost:5173/**
+
+> ⚠️ 不要打开 `http://localhost:3100/` —— 那是 API 端口，UI 走 5173。
+
+---
+
+## 第一个 goal
+
+进入 Dashboard 你会看到 "为 AI 提供一个目标" 输入框。试这几个例子（都是 1-3 美元成本能完成的）：
+
+```
+读穿 ~/Documents 下的所有 PDF，给我一份"我半年前在关心什么"的总结
+```
+
+```
+研究 2026 年开源 AI agent 框架 landscape，给我一份带引用的 markdown 报告
+```
+
+```
+扫一遍我的 GitHub 仓库，列出 README 写了但代码没实现的"虚假承诺"
+```
+
+点 **「启动目标循环」** 之后：
+- 系统会派出多个 agent 并行干活（Dashboard 下面的「子进程 Runs」面板可以实时看每个 agent 在调什么工具）
+- 几分钟到十几分钟完成（看 goal 复杂度）
+- 产物默认落在 `~/.soloco/goals/<goal-id>/workspace/` 下（点 goal 详情页能看到路径）
+
+---
+
+## 常见问题
+
+**报「无法连接 Soloco 服务」**
+你打开了 3100 而不是 5173。换 5173。
+
+**`pnpm dev` 报 `❌ 端口 3100 已被 PID=xxx 占用`**
+之前的 Soloco 进程没退干净。Windows: `taskkill /F /PID xxx`；Mac/Linux: `kill -9 xxx`。或在 `.env` 加 `PORT=3101`。
+
+**`pnpm dev` 启动了但报 `ANTHROPIC_API_KEY 未配置`**
+是 warn 不阻塞启动，但 conductor 调 Claude 会失败。检查 `server/.env` 里的 `ANTHROPIC_API_KEY` 那行。
+
+**Goal 跑很久卡住**
+看 Dashboard 上 goal 卡片右上角，点「强制终止」。或者在 goal 详情页的「子进程 Runs」面板看每个 agent 到底卡在哪。
+
+**想看错误日志**
+`~/.soloco/logs/error.log` —— 报 bug 时把这个文件相关行贴出来即可，敏感信息（API key/token）已自动遮蔽。
+
+---
+
+## 数据流向 / 隐私
+
+- 完全在你本机：goal 内容、workspace 文件、subprocess 输出、conductor session、组织快照
+- 会发给 Anthropic：所有 conductor / agent 的 prompt 与 response（走你的 Claude 订阅）
+- 会发给第三方：你装的每个 MCP（如浏览器 MCP 会发目标网站；computer-use 不发外网）
+- **不**会做的：Soloco 团队不收集你的数据、不上报使用量、不挂 telemetry
+
+详见 [NOTICE](./NOTICE)。
+
+---
+
+## 面向开发者
+
+如果你需要更深入的架构 / agent 编排 / runtime 哲学说明，进 [doc/plans/](./doc/plans/)。
+关键文档：
+
+- [doc/plans/2026-04-29-agentic-runtime-philosophy.md](./doc/plans/2026-04-29-agentic-runtime-philosophy.md) — runtime 与 model adapter 分层 + 开放原则
+- [doc/plans/2026-04-28-venture-roadmap.md](./doc/plans/2026-04-28-venture-roadmap.md) — venture 体系总规划
+
+---
+
+## License
+
+Soloco 是闭源专有软件，详见 [LICENSE](./LICENSE)。
+源自 paperclip 框架，相关 attribution 见 [NOTICE](./NOTICE)。
+
+商务/授权咨询：联系 Soloco AI。