workspacecord 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xuhongbo and workspacecord contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,190 @@
+# workspacecord
+
+[![CI](https://github.com/xuhongbo/WorkspaceCord/actions/workflows/ci.yml/badge.svg)](https://github.com/xuhongbo/WorkspaceCord/actions/workflows/ci.yml)
+[![npm version](https://badge.fury.io/js/workspacecord.svg)](https://www.npmjs.com/package/workspacecord)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D22.6.0-brightgreen)](https://nodejs.org)
+
+> Run and manage multi-agent coding sessions from Discord, backed by local projects on your machine.
+
+[简体中文说明](./README.zh-CN.md)
+
+> Repository name: `workspacecord`  
+> CLI/package name: `workspacecord`
+
+## Overview
+
+`workspacecord` maps Discord structures to local development workflows:
+
+```text
+Discord Server
+└─ Category = Project
+   ├─ #history (Forum) = Archived Sessions
+   └─ #claude-fix-login = Main Agent Session
+      └─ [sub:codex] benchmark = Subagent Thread
+```
+
+- A `Category` represents one mounted local project.
+- A `TextChannel` represents a main agent session.
+- A `Thread` represents a subagent.
+- The `#history` forum stores archived sessions.
+
+## Features
+
+- Explicit local project mounting with `workspacecord project init`
+- Discord-side project binding with `/project setup`
+- Main session channels and subagent threads
+- Session archiving into `#history`
+- Support for both Claude and Codex providers
+- Global config storage without requiring a project-local `.env`
+- Optional daemon install and background management
+
+## Requirements
+
+- `Node >= 22.6.0`
+- `pnpm`
+- A Discord application, bot token, client ID, and guild ID
+
+## File Locations
+
+- **Config**: `~/.config/workspacecord/config.json` - Global configuration
+- **Data**: `~/.workspacecord/` - Projects, sessions, and logs
+
+## Installation
+
+```bash
+pnpm install
+pnpm build
+pnpm link --global
+```
+
+After linking, you can use either the full command or the short alias:
+
+```bash
+workspacecord  # Full command
+wsc            # Short alias
+```
+
+## Quick Start
+
+### 1. Configure global credentials
+
+```bash
+workspacecord config setup
+```
+
+Or set values directly:
+
+```bash
+workspacecord config set DISCORD_TOKEN <token>
+workspacecord config set DISCORD_CLIENT_ID <client-id>
+workspacecord config set DISCORD_GUILD_ID <guild-id>
+workspacecord config set ALLOW_ALL_USERS true
+```
+
+### 2. Mount a local project
+
+Run inside your project directory:
+
+```bash
+workspacecord project init --name my-project
+```
+
+### 3. Start the bot
+
+```bash
+workspacecord
+```
+
+### 4. Bind the Discord category to the mounted project
+
+Run this in the text channel you want to use as the dedicated control channel for new sessions:
+
+```text
+/project setup project:my-project
+```
+
+If successful, `workspacecord` creates or reuses the `#history` forum automatically and records the current channel as the control channel for `/agent spawn`.
+
+## Commands
+
+### Local CLI
+
+**Config Management:**
+```bash
+workspacecord config setup              # Interactive configuration wizard
+workspacecord config get <key>          # Read a configuration value
+workspacecord config set <key> <value>  # Write a configuration value
+workspacecord config list               # List all configuration values
+workspacecord config path               # Show the config file path
+```
+
+**Project Management:**
+```bash
+workspacecord project init [--name <name>]  # Mount current directory as a project
+workspacecord project list                  # List all mounted projects
+workspacecord project info                  # Show current project info
+workspacecord project rename <new-name>     # Rename current project
+workspacecord project remove                # Unmount current project
+```
+
+**Daemon Management:**
+```bash
+workspacecord daemon install    # Install as system daemon (auto-start on boot)
+workspacecord daemon uninstall  # Uninstall daemon (alias: remove)
+workspacecord daemon status     # Check daemon status
+```
+
+**Advanced:**
+```bash
+workspacecord codex [options]   # Launch managed Codex session with remote approval
+```
+
+**Note:** All commands support the short alias `wsc`. For example: `wsc config list`
+
+### Discord Slash Commands
+
+- `/project setup` — bind the current category to a mounted project and mark the current channel as the control channel
+- `/project info` — inspect project binding details
+- `/agent spawn` — create a main agent session channel from the project control channel
+- `/agent archive` — archive the current session into `#history`
+- `/agent mode` / `/agent goal` / `/agent persona` / `/agent model`
+- `/subagent run` — create a subagent thread under the current session
+- `/subagent list` — list subagents for the current session
+- `/shell run` / `/shell processes` / `/shell kill`
+
+## Development
+
+Run the standard verification flow:
+
+```bash
+pnpm typecheck
+pnpm build
+pnpm test
+```
+
+Additional scripts:
+
+```bash
+pnpm test:integration:smoke
+pnpm test:multi-session:smoke
+pnpm test:session-sync:smoke
+pnpm test:monitor:e2e
+pnpm test:acceptance:local
+```
+
+See also: [`docs/ACCEPTANCE.md`](./docs/ACCEPTANCE.md)
+
+## Contributing
+
+We welcome contributions! Please read [CONTRIBUTING.md](./CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.
+
+## Acknowledgments
+
+This project was inspired by:
+- [agentcord](https://github.com/radu2lupu/agentcord) - Discord integration for AI agents
+- [clawd-on-desk](https://github.com/rullerzhou-afk/clawd-on-desk) - Claude desktop integration

package/README.zh-CN.md

@@ -0,0 +1,190 @@
+# workspacecord
+
+[![CI](https://github.com/xuhongbo/WorkspaceCord/actions/workflows/ci.yml/badge.svg)](https://github.com/xuhongbo/WorkspaceCord/actions/workflows/ci.yml)
+[![npm version](https://badge.fury.io/js/workspacecord.svg)](https://www.npmjs.com/package/workspacecord)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D22.6.0-brightgreen)](https://nodejs.org)
+
+> 通过 Discord 在本机项目上运行和管理多代理编程会话。
+
+[English README](./README.md)
+
+> 仓库名：`workspacecord`  
+> 命令行与包名：`workspacecord`
+
+## 概览
+
+`workspacecord` 把 Discord 结构映射到本地开发流程：
+
+```text
+Discord Server
+└─ Category = Project
+   ├─ #history (Forum) = Archived Sessions
+   └─ #claude-fix-login = Main Agent Session
+      └─ [sub:codex] benchmark = Subagent Thread
+```
+
+- `Category` 表示一个已挂载的本地项目。
+- `TextChannel` 表示一个主代理会话。
+- `Thread` 表示一个子代理。
+- `#history` Forum 用于存放归档会话。
+
+## 特性
+
+- 使用 `workspacecord project init` 显式挂载本地项目
+- 使用 `/project setup` 在 Discord 中绑定项目
+- 主会话频道与子代理线程模型
+- 会话自动归档到 `#history`
+- 同时支持 Claude 与 Codex 提供方
+- 使用全局配置存储，不依赖项目内 `.env`
+- 支持守护进程安装与后台管理
+
+## 环境要求
+
+- `Node >= 22.6.0`
+- `pnpm`
+- 一个可用的 Discord 应用、机器人令牌、客户端编号与服务器编号
+
+## 文件位置
+
+- **配置文件**: `~/.config/workspacecord/config.json` - 全局配置
+- **数据目录**: `~/.workspacecord/` - 项目、会话和日志
+
+## 安装
+
+```bash
+pnpm install
+pnpm build
+pnpm link --global
+```
+
+安装后可使用全局命令或短别名：
+
+```bash
+workspacecord  # 完整命令
+wsc            # 短别名
+```
+
+## 快速开始
+
+### 1. 配置全局凭据
+
+```bash
+workspacecord config setup
+```
+
+也可以直接写入：
+
+```bash
+workspacecord config set DISCORD_TOKEN <token>
+workspacecord config set DISCORD_CLIENT_ID <client-id>
+workspacecord config set DISCORD_GUILD_ID <guild-id>
+workspacecord config set ALLOW_ALL_USERS true
+```
+
+### 2. 挂载本地项目
+
+在目标项目目录中执行：
+
+```bash
+workspacecord project init --name my-project
+```
+
+### 3. 启动机器人
+
+```bash
+workspacecord
+```
+
+### 4. 在 Discord 中绑定项目
+
+在目标 Category 下你希望作为“新会话控制频道”的那个文本频道执行：
+
+```text
+/project setup project:my-project
+```
+
+绑定成功后会自动创建或复用 `#history` Forum，并把当前频道记录为 `/agent spawn` 的专用控制频道。
+
+## 主要命令
+
+### 本地 CLI
+
+**配置管理：**
+```bash
+workspacecord config setup              # 交互式配置向导
+workspacecord config get <key>          # 读取配置值
+workspacecord config set <key> <value>  # 写入配置值
+workspacecord config list               # 列出所有配置
+workspacecord config path               # 显示配置文件路径
+```
+
+**项目管理：**
+```bash
+workspacecord project init [--name <name>]  # 将当前目录挂载为项目
+workspacecord project list                  # 列出所有已挂载项目
+workspacecord project info                  # 显示当前项目信息
+workspacecord project rename <new-name>     # 重命名当前项目
+workspacecord project remove                # 卸载当前项目
+```
+
+**守护进程管理：**
+```bash
+workspacecord daemon install    # 安装为系统守护进程（开机自启）
+workspacecord daemon uninstall  # 卸载守护进程（别名：remove）
+workspacecord daemon status     # 查看守护进程状态
+```
+
+**高级功能：**
+```bash
+workspacecord codex [options]   # 启动托管的 Codex 会话（支持远程审批）
+```
+
+**注意：** 所有命令都支持短别名 `wsc`。例如：`wsc config list`
+
+### Discord Slash Commands
+
+- `/project setup`：把当前 Category 绑定到已挂载项目，并把当前频道设为控制频道
+- `/project info`：查看项目绑定信息
+- `/agent spawn`：在项目控制频道中创建主代理会话频道
+- `/agent archive`：把当前会话归档到 `#history`
+- `/agent mode` / `/agent goal` / `/agent persona` / `/agent model`
+- `/subagent run`：在当前主会话下创建子代理线程
+- `/subagent list`：查看当前会话的子代理
+- `/shell run` / `/shell processes` / `/shell kill`
+
+## 开发与验证
+
+建议先运行基础验证：
+
+```bash
+pnpm typecheck
+pnpm build
+pnpm test
+```
+
+更多脚本：
+
+```bash
+pnpm test:integration:smoke
+pnpm test:multi-session:smoke
+pnpm test:session-sync:smoke
+pnpm test:monitor:e2e
+pnpm test:acceptance:local
+```
+
+另见：[`docs/ACCEPTANCE.md`](./docs/ACCEPTANCE.md)
+
+## 贡献
+
+欢迎贡献！请阅读 [CONTRIBUTING.md](./CONTRIBUTING.md) 了解行为准则和提交流程。
+
+## 许可证
+
+本项目采用 MIT 许可证 - 详见 [LICENSE](./LICENSE) 文件。
+
+## 致谢
+
+本项目受以下项目启发：
+- [agentcord](https://github.com/radu2lupu/agentcord) - AI 代理的 Discord 集成
+- [clawd-on-desk](https://github.com/rullerzhou-afk/clawd-on-desk) - Claude 桌面集成