octocode-cli 1.3.1 → 1.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (102) hide show
  1. package/README.md +193 -34
  2. package/out/chunks/chunk-7476PETK.js +309 -0
  3. package/out/chunks/chunk-CVNNNSMQ.js +26 -0
  4. package/out/chunks/chunk-OQBJTZWK.js +60 -0
  5. package/out/chunks/chunk-UCZCF3BQ.js +9 -0
  6. package/out/chunks/command-help-specs-JZXVSLZ5.js +8 -0
  7. package/out/chunks/commands-XBFPLHSQ.js +8 -0
  8. package/out/chunks/help-P7TCOYAJ.js +10 -0
  9. package/out/chunks/main-help-ULF5PAQY.js +10 -0
  10. package/out/chunks/prompts-5E6VKRX5.js +8 -0
  11. package/out/chunks/spinner-URV2OX6O.js +8 -0
  12. package/out/chunks/tool-command-M6VA7P2F.js +8 -0
  13. package/out/octocode-cli.js +1 -1
  14. package/package.json +5 -3
  15. package/skills/README.md +13 -1
  16. package/skills/agentic-flow-best-practices/SKILL.md +280 -0
  17. package/skills/agentic-flow-best-practices/references/agent-collaboration-patterns.md +75 -0
  18. package/skills/agentic-flow-best-practices/references/pr-review-agent-example.md +47 -0
  19. package/skills/agentic-flow-best-practices/references/resources.md +112 -0
  20. package/skills/octocode-chrome-devtools/README.md +541 -0
  21. package/skills/octocode-chrome-devtools/SKILL.md +197 -0
  22. package/skills/octocode-chrome-devtools/agents/openai.yaml +7 -0
  23. package/skills/octocode-chrome-devtools/references/CDP_AGENT_REFERENCE.md +401 -0
  24. package/skills/octocode-chrome-devtools/references/CHROME_FLAGS.md +234 -0
  25. package/skills/octocode-chrome-devtools/references/INTENTS.md +108 -0
  26. package/skills/octocode-chrome-devtools/references/INTENTS_AUTH.md +179 -0
  27. package/skills/octocode-chrome-devtools/references/INTENTS_AUTOMATION.md +214 -0
  28. package/skills/octocode-chrome-devtools/references/INTENTS_DEBUG.md +329 -0
  29. package/skills/octocode-chrome-devtools/references/INTENTS_ENVIRONMENT.md +237 -0
  30. package/skills/octocode-chrome-devtools/references/INTENTS_INSPECT.md +263 -0
  31. package/skills/octocode-chrome-devtools/references/INTENTS_STORAGE_CONSENT.md +214 -0
  32. package/skills/octocode-chrome-devtools/references/RECOVERY.md +39 -0
  33. package/skills/octocode-chrome-devtools/references/SCRIPT_PATTERNS.md +43 -0
  34. package/skills/octocode-chrome-devtools/references/SCRIPT_PATTERNS_ASYNC_WORKERS.md +345 -0
  35. package/skills/octocode-chrome-devtools/references/SCRIPT_PATTERNS_BROWSER.md +403 -0
  36. package/skills/octocode-chrome-devtools/references/SCRIPT_PATTERNS_OBSERVE.md +275 -0
  37. package/skills/octocode-chrome-devtools/references/SCRIPT_PATTERNS_SPECIAL.md +18 -0
  38. package/skills/octocode-chrome-devtools/scripts/cdp-runner.mjs +503 -0
  39. package/skills/octocode-chrome-devtools/scripts/cdp-sandbox.mjs +123 -0
  40. package/skills/octocode-chrome-devtools/scripts/cdp-template.mjs +81 -0
  41. package/skills/octocode-chrome-devtools/scripts/octocode-chrome-devtools.vpn.example.json +8 -0
  42. package/skills/octocode-chrome-devtools/scripts/open-browser.mjs +362 -0
  43. package/skills/octocode-chrome-devtools/scripts/sourcemap-resolver.mjs +193 -0
  44. package/skills/octocode-chrome-devtools/scripts/undercover.mjs +226 -0
  45. package/skills/octocode-design/README.md +2 -2
  46. package/skills/octocode-documentation-writer/README.md +1 -1
  47. package/skills/octocode-engineer/README.md +1 -1
  48. package/skills/octocode-engineer/SKILL.md +4 -2
  49. package/skills/octocode-engineer/references/output-files.md +3 -3
  50. package/skills/octocode-engineer/scripts/run.js +136 -136
  51. package/skills/octocode-engineer/src/reporting/summary-md.test.ts +48 -0
  52. package/skills/octocode-engineer/src/reporting/summary-md.ts +43 -2
  53. package/skills/octocode-install/SKILL.md +1 -1
  54. package/skills/octocode-pull-request-reviewer/README.md +5 -5
  55. package/skills/octocode-pull-request-reviewer/SKILL.md +1 -1
  56. package/skills/octocode-research/AGENTS.md +1 -1
  57. package/skills/octocode-research/README.md +2 -2
  58. package/skills/octocode-research/docs/ARCHITECTURE.md +1 -1
  59. package/skills/octocode-research/scripts/server.js +191 -246
  60. package/skills/octocode-research/src/routes/github.ts +4 -21
  61. package/skills/octocode-research/src/routes/local.ts +4 -21
  62. package/skills/octocode-research/src/utils/fileContentTransform.ts +44 -0
  63. package/skills/octocode-search-skill/SKILL.md +245 -229
  64. package/skills/octocode-search-skill/references/agent-skills-guide.md +177 -0
  65. package/skills/octocode-search-skill/references/discovery-surfaces.md +162 -0
  66. package/skills/octocode-search-skill/references/fetch-and-create-locally.md +57 -0
  67. package/skills/octocode-search-skill/references/install-reference.md +130 -0
  68. package/skills/octocode-search-skill/references/references-template.md +27 -0
  69. package/skills/octocode-search-skill/references/references.md +62 -0
  70. package/skills/octocode-slides/README.md +307 -0
  71. package/skills/octocode-slides/SKILL.md +410 -0
  72. package/skills/octocode-slides/references/01-brief.md +156 -0
  73. package/skills/octocode-slides/references/02-research.md +149 -0
  74. package/skills/octocode-slides/references/03-outline.md +172 -0
  75. package/skills/octocode-slides/references/04-design.md +301 -0
  76. package/skills/octocode-slides/references/05-implementation.md +213 -0
  77. package/skills/octocode-slides/references/06-review.md +258 -0
  78. package/skills/octocode-slides/references/animation.md +281 -0
  79. package/skills/octocode-slides/references/design-system.md +316 -0
  80. package/skills/octocode-slides/references/html-templates.md +673 -0
  81. package/skills/octocode-slides/references/image-generation.md +448 -0
  82. package/skills/octocode-slides/references/resources.md +840 -0
  83. package/skills/octocode-slides/references/slide-rules.md +541 -0
  84. package/skills/octocode-slides/references/wireframes.md +727 -0
  85. package/skills/octocode-slides/scripts/animation.js +182 -0
  86. package/skills/octocode-slides/scripts/base.css +353 -0
  87. package/skills/octocode-slides/scripts/base.html +655 -0
  88. package/skills/octocode-slides/scripts/generate_image.py +221 -0
  89. package/skills/octocode-slides/scripts/navbridge.js +79 -0
  90. package/skills/octocode-slides/scripts/presenter.js +316 -0
  91. package/skills/octocode-slides/scripts/slide.html +248 -0
  92. package/skills/octocode-stats/SKILL.md +73 -0
  93. package/skills/octocode-stats/assets/template.html +1332 -0
  94. package/skills/octocode-stats/scripts/build_dashboard.mjs +407 -0
  95. package/assets/example.png +0 -0
  96. package/out/chunks/chunk-QCY7Q7YW.js +0 -389
  97. package/out/chunks/command-help-specs-CQ3RBLP6.js +0 -8
  98. package/out/chunks/commands-OCTZP2TO.js +0 -51
  99. package/out/chunks/help-XPXP46ZT.js +0 -10
  100. package/out/chunks/main-help-35HX2UDQ.js +0 -10
  101. package/out/chunks/tool-command-HOSMVLNK.js +0 -8
  102. package/skills/octocode-search-skill/INSTALL_REFERENCE.md +0 -112
@@ -1,10 +0,0 @@
1
- #!/usr/bin/env node
2
- import { createRequire as __createRequire } from 'module';
3
- import { fileURLToPath as __fileURLToPath } from 'url';
4
- import { dirname as __dirname_fn } from 'path';
5
- const require = __createRequire(import.meta.url);
6
- const __filename = __fileURLToPath(import.meta.url);
7
- const __dirname = __dirname_fn(__filename);
8
- import{a as n,b as s,c as p}from"./chunk-V64AXUWB.js";import"./chunk-YBBF4DTY.js";function r(t){let o=["",` ${n("magenta",s("\u{1F50D}\u{1F419} octocode-cli "+t.name))}`,"",` ${t.description}`,""];if(t.usage&&(o.push(` ${s("USAGE")}`),o.push(` ${t.usage.replace(/\boctocode\b/g,"octocode-cli")}`),o.push("")),t.options&&t.options.length>0){o.push(` ${s("OPTIONS")}`);for(let e of t.options){let i=e.short?`-${e.short}, `:" ",u=`--${e.name}`,c=e.hasValue?" <value>":"",l=e.default!==void 0?p(` (default: ${e.default})`):"";o.push(` ${n("cyan",i+u+c)}${l}`),o.push(` ${e.description}`)}o.push("")}process.stdout.write(`${o.join(`
9
- `)}
10
- `)}export{r as showCommandHelp};
@@ -1,10 +0,0 @@
1
- #!/usr/bin/env node
2
- import { createRequire as __createRequire } from 'module';
3
- import { fileURLToPath as __fileURLToPath } from 'url';
4
- import { dirname as __dirname_fn } from 'path';
5
- const require = __createRequire(import.meta.url);
6
- const __filename = __fileURLToPath(import.meta.url);
7
- const __dirname = __dirname_fn(__filename);
8
- import{c as i,e as r}from"./chunk-QCY7Q7YW.js";import{a as o,b as t,c as e}from"./chunk-V64AXUWB.js";import"./chunk-YBBF4DTY.js";function u(){let c=["GitHub","Local","LSP","Package"],n=[];for(let l of c){let s=i.filter(a=>r(a.name)===l);if(s.length!==0){n.push(` ${e(l)}`);for(let a of s){let $=a.name.padEnd(28);n.push(` ${o("cyan",$)} ${e("--tool")} ${a.name}`)}}}return n}function m(){let c=u(),n=["",` ${o("magenta",t("\u{1F50D}\u{1F419} Octocode CLI"))}`,"",` ${t("Two things in one binary:")}`,` ${o("magenta","1.")} ${t("Manage")} \u2014 install, auth, skills, MCP marketplace, sync, cache`,` ${o("magenta","2.")} ${t("Run tools")} \u2014 call any Octocode tool directly from terminal`,"",` ${t("USAGE")}`,` ${o("magenta","octocode-cli")} <command> [options] ${e("manage Octocode")}`,` ${o("magenta","octocode-cli")} --tool <name> --queries '<json>' ${e("run a tool")}`,"",` ${t("COMMANDS")} ${e("(manage Octocode configuration)")}`,` ${o("magenta","install")} Configure octocode-mcp for an IDE`,` ${o("magenta","auth")} Manage GitHub authentication`,` ${o("magenta","login / logout")} Sign in or out of GitHub`,` ${o("magenta","status / token")} Show auth status or print token`,` ${o("magenta","skills")} Install/remove bundled Octocode skills`,` ${o("magenta","mcp")} Manage MCP marketplace`,` ${o("magenta","sync")} Sync MCP configs across IDEs`,` ${o("magenta","cache")} Inspect and clean Octocode cache`,"",` ${t("TOOLS")} ${e("(run Octocode tools directly \u2014 for agents and humans)")}`,...c,"",` ${t("OPTIONS")}`,` ${o("cyan","--tool <name> --queries '<json>'")} Run a tool`,` ${o("cyan","--tool <name> --help")} Show tool input/output schema`,` ${o("cyan","--tools-context")} Full MCP instructions + all schemas`,` ${o("cyan","--json")} Raw JSON output`,` ${o("cyan","-h, --help")} Show this help`,` ${o("cyan","-v, --version")} Show version`,"",` ${t("EXAMPLES")}`,` ${e("# Run a tool")}`,` ${o("yellow",`octocode-cli --tool localSearchCode --queries '{"path":".","pattern":"runCLI"}'`)}`,` ${o("yellow",`octocode-cli --tool githubSearchCode --queries '{"keywordsToSearch":["hook"],"owner":"facebook","repo":"react"}'`)}`,"",` ${e("# Discover tools")}`,` ${o("yellow","octocode-cli --tool githubSearchCode --help")}`,` ${o("yellow","octocode-cli --tools-context")}`,"",` ${e("# Manage Octocode")}`,` ${o("yellow","octocode-cli install --ide cursor")}`,` ${o("yellow","octocode-cli skills install --targets claude-code,cursor")}`,"",o("magenta",` \u2500\u2500\u2500 \u{1F50D}\u{1F419} ${t("https://octocode.ai")} \u2500\u2500\u2500`),""];process.stdout.write(`${n.join(`
9
- `)}
10
- `)}export{m as showHelp};
@@ -1,8 +0,0 @@
1
- #!/usr/bin/env node
2
- import { createRequire as __createRequire } from 'module';
3
- import { fileURLToPath as __fileURLToPath } from 'url';
4
- import { dirname as __dirname_fn } from 'path';
5
- const require = __createRequire(import.meta.url);
6
- const __filename = __fileURLToPath(import.meta.url);
7
- const __dirname = __dirname_fn(__filename);
8
- import{b as a,c as b,d as c,e as d,f as e,g as f,h as g,i as h,j as i,k as j,l as k}from"./chunk-QCY7Q7YW.js";import"./chunk-V64AXUWB.js";import"./chunk-YBBF4DTY.js";export{a as AUTO_FILLED_FIELDS,b as TOOL_DEFINITIONS,j as executeToolCommand,c as findToolDefinition,e as getDisplayFields,d as getToolCategory,h as getToolsContextString,i as printToolsContext,f as showAvailableTools,g as showToolHelp,k as toolCommand};
@@ -1,112 +0,0 @@
1
- # Install Reference
2
-
3
- Use this only when the user chooses `Install a skill`.
4
-
5
- ## Validate Against Repo
6
-
7
- If install behavior is unclear or may have changed, check these files before acting:
8
-
9
- ```text
10
- packages/octocode-cli/docs/SKILLS_GUIDE.md
11
- packages/octocode-cli/src/cli/commands/skills.ts
12
- packages/octocode-cli/src/utils/skills.ts
13
- packages/octocode-cli/src/utils/skills-fetch.ts
14
- packages/octocode-cli/src/ui/skills-menu/marketplace.ts
15
- ```
16
-
17
- GitHub references:
18
-
19
- ```text
20
- https://github.com/bgauryy/octocode-mcp/blob/main/packages/octocode-cli/docs/SKILLS_GUIDE.md
21
- https://github.com/bgauryy/octocode-mcp/blob/main/packages/octocode-cli/src/cli/commands/skills.ts
22
- https://github.com/bgauryy/octocode-mcp/blob/main/packages/octocode-cli/src/utils/skills.ts
23
- https://github.com/bgauryy/octocode-mcp/blob/main/packages/octocode-cli/src/utils/skills-fetch.ts
24
- https://github.com/bgauryy/octocode-mcp/blob/main/packages/octocode-cli/src/ui/skills-menu/marketplace.ts
25
- ```
26
-
27
- What to verify:
28
- - `SKILLS_GUIDE.md`: current CLI examples, target names, default destinations, and `skillsDestDir`.
29
- - `skills.ts`: default destination resolution and custom `skillsDestDir` behavior.
30
- - `commands/skills.ts`: supported target names, prompts, install modes, conflict handling, and `--force` behavior.
31
- - `skills-fetch.ts`: how marketplace skills are downloaded and written to disk.
32
- - `marketplace.ts`: interactive marketplace prompts and install confirmation wording.
33
-
34
- ## Input
35
-
36
- Install input is a GitHub skill path, not only a skill name.
37
-
38
- Accepted forms:
39
-
40
- ```text
41
- owner/repo/path/to/skill
42
- owner/repo/path/to/skill/SKILL.md
43
- https://github.com/<owner>/<repo>/tree/<branch>/<path-to-skill-folder>
44
- https://github.com/<owner>/<repo>/blob/<branch>/<path-to-skill-folder>/SKILL.md
45
- ```
46
-
47
- Normalize `.../SKILL.md` to the containing folder. Derive `skill-name` from the final folder segment.
48
-
49
- ## Targets
50
-
51
- Default skill directories:
52
-
53
- ```text
54
- claude-code: ~/.claude/skills/
55
- claude-desktop: ~/.claude-desktop/skills/
56
- cursor: ~/.cursor/skills/
57
- codex: ~/.codex/skills/
58
- opencode: ~/.opencode/skills/
59
- ```
60
-
61
- For project-scoped Claude Code installs, `~/.octocode/config.json` can set:
62
-
63
- ```json
64
- { "skillsDestDir": "/your/project/.claude/skills" }
65
- ```
66
-
67
- This customizes the `claude-code` destination only.
68
-
69
- ## Install Steps
70
-
71
- 1. Validate the source path resolves to a folder containing `SKILL.md`.
72
- 2. Confirm source path, description, targets, and install mode.
73
- 3. Prefer copy. Use symlink only when the source folder is stable.
74
- 4. Check conflicts:
75
-
76
- ```bash
77
- ls "<dest>/<skill-name>"
78
- ```
79
-
80
- If the folder exists, ask: `Overwrite`, `Skip`, or `Cancel`.
81
-
82
- 5. Download the skill folder:
83
-
84
- ```text
85
- githubGetFileContent(queries: [{
86
- id: "download",
87
- owner,
88
- repo,
89
- path: "<path-to-skill-folder>",
90
- type: "directory"
91
- }])
92
- ```
93
-
94
- 6. Verify the returned folder:
95
-
96
- ```bash
97
- ls "<localPath>/SKILL.md"
98
- ```
99
-
100
- 7. Install:
101
-
102
- ```bash
103
- cp -r "<localPath>" "<dest>/<skill-name>"
104
- ```
105
-
106
- 8. Verify every destination:
107
-
108
- ```bash
109
- ls "<dest>/<skill-name>/SKILL.md"
110
- ```
111
-
112
- Report success or failure per target.