@oh-gc/cli 0.7.4 → 0.7.6

package/dist/commands/user/starred.js

@@ -38,9 +38,9 @@ class UserStarred extends base_command_1.BaseCommand {
 }
 UserStarred.description = 'List starred repositories';
 UserStarred.examples = [
-    '<%= config.bin %> user:starred',
-    '<%= config.bin %> user:starred alice',
-    '<%= config.bin %> user:starred --sort last_push',
+    '<%= config.bin %> user starred',
+    '<%= config.bin %> user starred alice',
+    '<%= config.bin %> user starred --sort last_push',
 ];
 UserStarred.flags = {
     ...base_command_1.BaseCommand.baseFlags,

package/dist/commands/user/subscriptions.js

@@ -38,9 +38,9 @@ class UserSubscriptions extends base_command_1.BaseCommand {
 }
 UserSubscriptions.description = 'List watched (subscribed) repositories';
 UserSubscriptions.examples = [
-    '<%= config.bin %> user:subscriptions',
-    '<%= config.bin %> user:subscriptions alice',
-    '<%= config.bin %> user:subscriptions --sort last_push',
+    '<%= config.bin %> user subscriptions',
+    '<%= config.bin %> user subscriptions alice',
+    '<%= config.bin %> user subscriptions --sort last_push',
 ];
 UserSubscriptions.flags = {
     ...base_command_1.BaseCommand.baseFlags,

package/dist/commands/user/view.js

@@ -33,8 +33,8 @@ class UserView extends base_command_1.BaseCommand {
 }
 UserView.description = 'View user profile';
 UserView.examples = [
-    '<%= config.bin %> user:view',
-    '<%= config.bin %> user:view alice',
+    '<%= config.bin %> user view',
+    '<%= config.bin %> user view alice',
 ];
 UserView.flags = {
     ...base_command_1.BaseCommand.baseFlags,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oh-gc/cli",
-  "version": "0.7.4",
+  "version": "0.7.6",
   "description": "GitCode CLI — manage issues and PRs from the terminal",
   "license": "MIT",
   "author": "guozejun",
@@ -33,7 +33,8 @@
     "dist/",
     "!dist/**/*.test.*",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "skills/"
   ],
   "oclif": {
     "bin": "oh-gc",
@@ -67,6 +68,7 @@
     "jest-fetch-mock": "^3",
     "ts-jest": "^29",
     "ts-node": "^10",
-    "typescript": "^5"
+    "typescript": "^5",
+    "unzipper": "^0.12.3"
   }
 }

package/skills/gitcode-cli/INSTALL.md

@@ -0,0 +1,112 @@
+# Installing the gitcode-cli Skill
+
+This document tells AI assistants how to install the `gitcode-cli` skill for Claude Code and Codex so it is available across projects and sessions.
+
+## Detect the User's AI Tool
+
+Check which tool the user is running and install accordingly:
+
+```bash
+which claude >/dev/null 2>&1 && echo "CLAUDE_CODE"
+which codex >/dev/null 2>&1 && echo "CODEX"
+```
+
+## Install for Claude Code
+
+Claude Code supports plugin marketplaces. The oh-gc CLI repository provides a marketplace for one-command installation:
+
+```text
+/plugin marketplace add https://gitcode.com/guozejun/ohos_gitcode_cli.git
+/plugin install gitcode-cli@oh-gc
+```
+
+The Claude plugin reads `skills/gitcode-cli/SKILL.md` from this repository. The Codex-only `skills/gitcode-cli/agents/openai.yaml` file can remain present; Claude ignores it.
+
+For a manual Claude Code install from a checkout of this repository:
+
+```bash
+mkdir -p "$HOME/.claude/skills/gitcode-cli"
+mkdir -p "$HOME/.claude/skills/gitcode-cli/references"
+cp skills/gitcode-cli/SKILL.md "$HOME/.claude/skills/gitcode-cli/SKILL.md"
+cp skills/gitcode-cli/references/commands.md "$HOME/.claude/skills/gitcode-cli/references/commands.md"
+```
+
+## Install for Codex
+
+Codex loads user skills from `$CODEX_HOME/skills`; when `CODEX_HOME` is not set, use `~/.codex/skills`. Install both `SKILL.md` and the Codex metadata under `agents/`.
+
+```bash
+# From a checkout of this repository
+mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills/gitcode-cli"
+mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills/gitcode-cli/agents"
+mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills/gitcode-cli/references"
+cp skills/gitcode-cli/SKILL.md "${CODEX_HOME:-$HOME/.codex}/skills/gitcode-cli/SKILL.md"
+cp skills/gitcode-cli/agents/openai.yaml "${CODEX_HOME:-$HOME/.codex}/skills/gitcode-cli/agents/openai.yaml"
+cp skills/gitcode-cli/references/commands.md "${CODEX_HOME:-$HOME/.codex}/skills/gitcode-cli/references/commands.md"
+```
+
+Start a new Codex session for the skill metadata to be discovered.
+
+## Install from npm
+
+If `oh-gc` was installed with npm and the package includes the skill files:
+
+```bash
+SKILL_SRC="$(npm root -g)/@oh-gc/cli/skills/gitcode-cli"
+
+# Codex
+mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills/gitcode-cli"
+mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills/gitcode-cli/agents"
+mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills/gitcode-cli/references"
+cp "$SKILL_SRC/SKILL.md" "${CODEX_HOME:-$HOME/.codex}/skills/gitcode-cli/SKILL.md"
+cp "$SKILL_SRC/agents/openai.yaml" "${CODEX_HOME:-$HOME/.codex}/skills/gitcode-cli/agents/openai.yaml"
+cp "$SKILL_SRC/references/commands.md" "${CODEX_HOME:-$HOME/.codex}/skills/gitcode-cli/references/commands.md"
+
+# Claude Code manual install
+mkdir -p "$HOME/.claude/skills/gitcode-cli"
+mkdir -p "$HOME/.claude/skills/gitcode-cli/references"
+cp "$SKILL_SRC/SKILL.md" "$HOME/.claude/skills/gitcode-cli/SKILL.md"
+cp "$SKILL_SRC/references/commands.md" "$HOME/.claude/skills/gitcode-cli/references/commands.md"
+```
+
+## Optional OpenCode Install
+
+OpenCode can consume the same `SKILL.md` by referencing it from `opencode.json`. Copy `references/commands.md` next to `SKILL.md` if you want the full command catalog available.
+
+```json
+{
+  "instructions": ["~/.config/opencode/skills/gitcode-cli/SKILL.md"]
+}
+```
+
+## Uninstall
+
+Claude Code marketplace:
+
+```text
+# Claude Code marketplace
+/plugin uninstall gitcode-cli
+```
+
+Manual installs:
+
+```bash
+rm -rf "$HOME/.claude/skills/gitcode-cli"
+rm -rf "${CODEX_HOME:-$HOME/.codex}/skills/gitcode-cli"
+```
+
+## Verification
+
+After installation, start a new session and ask:
+
+```text
+What oh-gc PR commands are available?
+```
+
+In Codex, explicit invocation should also work:
+
+```text
+Use $gitcode-cli to show available oh-gc PR commands.
+```
+
+If the skill is loaded, the assistant should answer from the `oh-gc` command reference without needing to inspect this repository.

package/skills/gitcode-cli/SKILL.md

@@ -0,0 +1,152 @@
+---
+name: gitcode-cli
+description: Use when managing GitCode repositories from the terminal with the oh-gc CLI, including auth, issues, PRs, reviewers, testers, labels, releases, repository settings, and GitCode URLs. Trigger when a user asks to run, choose, script, or troubleshoot oh-gc commands or interact with GitCode without a browser.
+---
+
+# oh-gc CLI - GitCode Command Line Tool
+
+**Version:** 0.7.6 | **Updated:** 2026-05-17
+
+`oh-gc` is a CLI for [GitCode](https://gitcode.com), modeled after GitHub CLI (`gh`). It manages authentication, issues, pull requests, releases, repository settings, and repository content from the terminal.
+
+**Package:** `npm install -g @oh-gc/cli` (requires Node.js 18+)
+
+For exact command flags and examples, read [references/commands.md](references/commands.md). If that file is unavailable, use `oh-gc <topic> <command> --help`.
+
+## Operating Rules
+
+- Before executing the first `oh-gc` command in a session, run `oh-gc --version`.
+- If `oh-gc` is missing or is not version `0.7.6`, install `npm install -g @oh-gc/cli@0.7.6` before using other `oh-gc` commands.
+- Follow the host tool's approval model for installation, login, publishing, network access, or any other restricted action.
+- Prefer `--json` for scripting and parse it with a structured parser such as `jq` when available.
+- Use `--repo owner/repo` when the current directory is not the target repository or when working across repositories.
+- Do not guess GitCode PR URLs: use `https://gitcode.com/{owner}/{repo}/pull/{number}` with singular `pull`.
+
+## State-Changing Commands
+
+Read-only commands can be run when they answer the user's request. For commands that mutate GitCode or git state, make sure the user explicitly requested the action and the target repository is unambiguous.
+
+State-changing actions include:
+
+- Creating, updating, closing, reopening, merging, approving, testing, assigning, labeling, linking, or deleting issues/PRs/comments.
+- Creating, updating, deleting, protecting, archiving, transferring, or changing settings for repos, branches, tags, files, collaborators, labels, milestones, hooks, SSH keys, modules, or permission modes.
+- Running `oh-gc release create`, which can run tests/builds, create commits/tags, push to git, create a GitCode release, and upload assets.
+
+For high-impact actions such as `repo delete`, `repo archive`, `repo transfer`, `release create`, `pr merge`, `branch delete`, `tag delete`, `file delete`, and forced review/test approval, restate the target and proceed only when the user's request is explicit.
+
+## Mandatory Preflight
+
+1. Version: `oh-gc --version`
+2. Auth: `oh-gc auth status`
+   - If not logged in: `oh-gc auth login`
+   - Token source: GitCode -> 个人设置 -> 访问令牌
+3. Repository context:
+   - Inside a git repo with a `gitcode.com` remote, or
+   - Pass `--repo owner/repo`
+
+Most repository commands support:
+
+- `--repo owner/repo` - target repository in OWNER/REPO format
+- `--json` - raw JSON output
+- `--help` - command help
+
+Remote override is stored at `.gitcode/oh-gc-config.json` and managed by `oh-gc repo set-remote <name>` / `oh-gc repo get-remote`.
+
+## PR Template Rule
+
+`oh-gc pr create` does **not** automatically read `.gitcode/PULL_REQUEST_TEMPLATE.md`. Agents must handle templates explicitly.
+
+Before creating a PR:
+
+1. Determine the target repository and base branch.
+2. Check for a template in the target repository:
+   - Local target repo: `test -f .gitcode/PULL_REQUEST_TEMPLATE.md && cat .gitcode/PULL_REQUEST_TEMPLATE.md`
+   - Remote/cross-repo target: `oh-gc file raw .gitcode/PULL_REQUEST_TEMPLATE.md <base-branch> --repo owner/repo`
+   - If the template lookup returns "not found", proceed without a template.
+3. If a template exists, build the PR body around its sections and fill them in.
+4. For non-interactive automation, pass the filled body with `--body`. Otherwise, create the PR and immediately run `oh-gc pr update <number> --body "<filled template>"`.
+5. Do not replace the template with a free-form body unless the user explicitly requests that.
+
+For fork-to-upstream PRs, `--repo` targets the upstream repo and `--head` must use `owner:branch` format, not `owner/branch`.
+
+```bash
+oh-gc pr create --repo upstream-owner/repo --head myname:my-feature --base main --title "Fix bug" --body "<filled template>"
+```
+
+## Common Workflows
+
+### Issue Triage
+
+```bash
+oh-gc issue list --search "crash"
+oh-gc issue view 15
+oh-gc issue comment 15 --body "Investigating, likely related to #12"
+oh-gc issue update 15 --labels "bug,P0" --assignee bob
+```
+
+### PR Review
+
+```bash
+oh-gc pr view 42 --json
+oh-gc pr diff 42
+oh-gc pr comments 42 --latest
+oh-gc pr comment 42 --body "Please update the tests."
+```
+
+Only approve, mark tests passed, or merge when explicitly requested:
+
+```bash
+oh-gc pr review 42
+oh-gc pr test 42
+oh-gc pr merge 42 --method squash
+```
+
+### Cross-Repo PR
+
+```bash
+oh-gc pr create --repo upstream-owner/repo --head myname:my-feature --base master --title "Fix bug" --body "<filled template or summary>"
+oh-gc pr view 42 --repo upstream-owner/repo --json
+```
+
+## Command Selection
+
+Read [references/commands.md](references/commands.md) for the full command catalog. This map is for choosing the command family quickly:
+
+- Auth: `oh-gc auth login/status/logout`
+- Issues: `oh-gc issue list/view/create/update/comment/close/reopen/labels/history/reactions/prs/branches`
+- PRs: `oh-gc pr list/view/create/update/close/reopen/diff/comment/comments/reviewers/testers/review/test/labels/link/merge/files/history/logs`
+- Repos: `oh-gc repo list/view/create/update/delete/fork/forks/settings/languages/contributors/events/stats/archive/transition/module/roles/transfer`
+- Users: `oh-gc user view/edit/emails/followers/following/events/search/keys/starred/subscriptions/issues/prs/orgs`
+- Branches/tags: `oh-gc branch ...`, `oh-gc tag ...`
+- Contents: `oh-gc file get/raw/list/create/update/delete`, `oh-gc commit ...`
+- Admin objects: `oh-gc collaborator ...`, `oh-gc label ...`, `oh-gc milestone ...`, `oh-gc hook ...`, `oh-gc org ...`
+- Search/release: `oh-gc search repos/issues/code`, `oh-gc release create`
+
+## Configuration
+
+| Setting | Location | How to set |
+|---------|----------|------------|
+| Auth token | `~/.config/gitcode-cli/config.json` | `oh-gc auth login` |
+| Remote override | `.gitcode/oh-gc-config.json` | `oh-gc repo set-remote <name>` |
+| Proxy | `https_proxy` / `HTTPS_PROXY` env var | Automatic |
+
+## Error Handling
+
+| Error | Cause | Fix |
+|-------|-------|-----|
+| "Not logged in" | No token configured | `oh-gc auth login` |
+| "Authentication failed" | Token expired or invalid | Re-run `oh-gc auth login` with a new token |
+| "Remote not found" | Not in a git repo or remote missing | `cd` to repo, check `git remote -v`, or pass `--repo owner/repo` |
+| "Not a GitCode repository" | Remote URL is not `gitcode.com` | Add a GitCode remote or pass `--repo owner/repo` |
+| "Could not connect" | Network/proxy issue | Check network; set `https_proxy` / `HTTPS_PROXY` if needed |
+| "Rate limit exceeded" | Too many API calls | Wait and retry |
+| "Can not find the branch" | Cross-repo PR `--head` lacks fork owner | Use `--head owner:branch` |
+| PR body missing template fields | Template was skipped or replaced | Read the template and update the PR body with filled sections |
+
+## Tips
+
+- `oh-gc file raw <path> <ref>` prints decoded content; `oh-gc file get <path> --ref <ref>` prints metadata plus base64 content.
+- `oh-gc pr comments --comment-type diff_comment` filters to code review comments.
+- `oh-gc pr reviewers --append` adds reviewers without replacing existing reviewers.
+- `oh-gc pr update --state closed` closes a PR without merging.
+- When reporting PR links, always use `https://gitcode.com/{owner}/{repo}/pull/{number}`.

package/skills/gitcode-cli/agents/openai.yaml

@@ -0,0 +1,7 @@
+interface:
+  display_name: "GitCode CLI"
+  short_description: "Manage GitCode repositories with oh-gc"
+  default_prompt: "Use $gitcode-cli to list open PRs for this GitCode repository."
+
+policy:
+  allow_implicit_invocation: true