@z40/magpie 1.0.0 → 1.0.1

package/LICENSE

@@ -0,0 +1,36 @@
+MIT License
+
+Copyright (c) cc-connect contributors (upstream: https://github.com/chenhg5/cc-connect)
+Copyright (c) 2026 ChamberZ40 (modifications in this fork)
+
+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.
+
+---
+
+Provenance note
+
+This repository is a fork of https://github.com/chenhg5/cc-connect, trimmed to a
+subset of its agents and platforms.
+
+Upstream ships no LICENSE file of its own; its MIT grant is declared in
+`npm/package.json` (`"license": "MIT"`). MIT permits redistribution and
+sublicensing provided the copyright and permission notice above is retained,
+which is why this fork is MIT rather than a public-domain dedication — a
+dedication would purport to waive rights in upstream's code that this fork does
+not hold.

package/README.md

@@ -7,25 +7,78 @@ the chat.
 Agents: Claude Code, Codex, Cursor Agent, GitHub Copilot CLI, and any
 ACP-speaking agent. Platforms: Feishu (Lark), WeChat Work, Weixin.
 
-## Install
+## Quick start
+
+**First, install the agent CLI you want to drive and log into it.** Magpie
+spawns it as a subprocess and inherits its credentials, so an agent that is
+not logged in fails on the first message. For Claude Code:
+
+```bash
+npm install -g @anthropic-ai/claude-code
+claude          # log in, then quit
+```
+
+**1. Install magpie.** This downloads the prebuilt binary for your platform
+from the matching GitHub release:
 
 ```bash
 npm install -g @z40/magpie
 ```
 
-This downloads the prebuilt binary for your platform from the matching GitHub
-release and installs it as `magpie`.
+**2. Create the config.** The first run writes `~/.magpie/config.toml` and
+exits — it does not start the bridge yet:
+
+```bash
+magpie
+# Created default config at /Users/you/.magpie/config.toml
+# Please edit this file to add your agent and platform credentials, then run magpie again.
+```
+
+**3. Fill it in.** Open that file and set `work_dir` to the project you want
+the agent to work in — it must already exist. Then add your bot credentials.
+For Feishu you can skip the hand-editing:
+
+```bash
+magpie feishu setup     # QR onboarding, or --app to bind an existing bot
+```
+
+For WeChat Work and Weixin, see the setup guides:
+[WeChat Work](https://github.com/ChamberZ40/magpie/blob/main/docs/wecom.md),
+[Weixin](https://github.com/ChamberZ40/magpie/blob/main/docs/weixin.md).
+`magpie config example` prints every option, annotated.
+
+**4. Start it.**
+
+```bash
+magpie
+```
+
+Message the bot from your chat app. A reply means the round trip works.
 
-## Usage
+**5. Keep it running** after you close the terminal:
 
 ```bash
-magpie                              # first run creates ~/.magpie/config.toml
-magpie --config /path/to/config.toml
+magpie daemon install     # installs and starts a launchd/systemd service
+magpie daemon logs -f     # follow the logs
 ```
 
-The first run prints a Web admin URL (`http://localhost:9820`) where you create
-a project and paste your bot credentials.
+### If something does not work
+
+```bash
+magpie doctor             # checks the local setup: agent CLI, config, permissions
+magpie config path        # where the config actually resolved to
+magpie --help             # every command, plus the agents and platforms this build ships
+```
 
 ## Documentation
 
 Full documentation: https://github.com/ChamberZ40/magpie
+
+## License and credits
+
+[MIT](https://github.com/ChamberZ40/magpie/blob/main/LICENSE).
+
+Magpie is a fork of [chenhg5/cc-connect](https://github.com/chenhg5/cc-connect),
+which declares MIT in its `npm/package.json`. Most of the code is upstream's;
+this fork trims it to the agents and platforms listed above and no longer
+tracks upstream. It is not affiliated with or endorsed by the upstream project.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@z40/magpie",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Bridge local AI coding agents (Claude Code, Codex, Cursor, GitHub Copilot, any ACP agent) to messaging platforms (Feishu/Lark, WeChat Work, Weixin)",
   "keywords": [
     "claude-code",