Onboarding Agent --help Crawl Discovery & GitHub CLI Agent

ts/packages/agents/github-cli/README.md

@@ -0,0 +1,73 @@
+# GitHub CLI Agent
+
+🐙 A TypeAgent agent for interacting with GitHub via the [GitHub CLI (`gh`)](https://cli.github.com/).
+
+## Prerequisites
+
+- [GitHub CLI](https://cli.github.com/) installed and on your `PATH`
+- Authenticated via `gh auth login`
+
+## Supported Actions
+
+| Category          | Actions                                                                                               |
+| ----------------- | ----------------------------------------------------------------------------------------------------- |
+| **Auth**          | Login, logout, check status                                                                           |
+| **Issues**        | Create, close, reopen, list, view, browse                                                             |
+| **Pull Requests** | Create (including draft), close, merge, list, view, checkout, browse                                  |
+| **Repos**         | Create, clone, delete, view (with field-specific queries like stars/forks), fork, star/unstar, browse |
+| **Search**        | Search repositories by keyword                                                                        |
+| **Status**        | Dashboard summary of notifications, PRs, and issues                                                   |
+| **Contributors**  | Top N contributors for a repo                                                                         |
+| **Dependabot**    | List alerts with severity/state filters                                                               |
+| **Workflows**     | View workflow runs and workflow details                                                               |
+| **Other**         | Codespaces, gists, releases, projects, labels, secrets, SSH keys, config, orgs                        |
+
+## Example Phrases
+
+```
+show my GitHub status
+list open PRs in microsoft/TypeAgent
+how many stars does microsoft/TypeAgent have
+show top 10 contributors for microsoft/TypeAgent
+create issue "Fix login bug" in microsoft/TypeAgent
+close issue 42 in microsoft/TypeAgent
+open a draft PR for my-feature branch
+show newest 5 dependabot alerts in microsoft/TypeAgent
+fork microsoft/TypeAgent
+star microsoft/TypeAgent
+```
+
+## Output Formatting
+
+- PR, issue, and repo listings include clickable **hyperlinks**
+- `repo view` answers specific questions (e.g., "how many stars") with a distilled one-line response
+- Status output uses **bold section headers** for readability
+- Dependabot alerts are color-coded by severity (🔴 critical, 🟠 high, 🟡 medium, 🟢 low)
+- Mutation actions (create, close, star, fork) return friendly emoji confirmation messages
+
+## Demo
+
+Demo scripts are available for replay in the TypeAgent shell and CLI:
+
+```bash
+# Shell (interactive)
+@demo github_cli
+
+# CLI
+npx agent-cli --demo demo/github_cli.txt
+```
+
+## Building
+
+```bash
+pnpm install
+pnpm run build
+```
+
+## Trademarks
+
+This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft
+trademarks or logos is subject to and must follow
+[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
+Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
+Any use of third-party trademarks or logos are subject to those third-party's policies.

ts/packages/agents/github-cli/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "github-cli-agent",
+  "version": "0.0.1",
+  "private": true,
+  "description": "TypeAgent agent for github-cli",
+  "homepage": "https://github.com/microsoft/TypeAgent#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/microsoft/TypeAgent.git",
+    "directory": "ts/packages/agents/github-cli"
+  },
+  "license": "MIT",
+  "author": "Microsoft",
+  "type": "module",
+  "exports": {
+    "./agent/manifest": "./src/github-cliManifest.json",
+    "./agent/handlers": "./dist/github-cliActionHandler.js"
+  },
+  "scripts": {
+    "agc": "agc -i ./src/github-cliSchema.agr -o ./dist/github-cliSchema.ag.json",
+    "asc": "asc -i ./src/github-cliSchema.ts -o ./dist/github-cliSchema.pas.json -t GithubCliActions",
+    "build": "concurrently npm:tsc npm:asc npm:agc",
+    "clean": "rimraf --glob dist *.tsbuildinfo *.done.build.log",
+    "tsc": "tsc -b"
+  },
+  "dependencies": {
+    "@typeagent/agent-sdk": "workspace:*"
+  },
+  "devDependencies": {
+    "@typeagent/action-schema-compiler": "workspace:*",
+    "action-grammar-compiler": "workspace:*",
+    "concurrently": "^9.1.2",
+    "rimraf": "^6.0.1",
+    "typescript": "~5.4.5"
+  }
+}