askshepherd 0.1.44 → 0.1.45
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.
- package/README.md +31 -6
- package/bin/shepherd-onboard.js +301 -41
- package/bin/shepherd.js +579 -32
- package/package.json +1 -1
- package/skills/shepherd/SKILL.md +37 -58
package/README.md
CHANGED
|
@@ -15,7 +15,7 @@ Use the Shepherd skill to onboard me to this repository before coding.
|
|
|
15
15
|
If the agent does not already have the skill, give it this bootstrap line:
|
|
16
16
|
|
|
17
17
|
```text
|
|
18
|
-
Set up Shepherd for me: run `npx -y askshepherd@latest agent-setup
|
|
18
|
+
Set up Shepherd for me: run `npx -y askshepherd@latest agent-setup` (installs the Codex usage skill by default; pass --install claude|all|none to change), then `npx -y askshepherd@latest guide`; follow the returned workflow, ask me where to install MCP tools, ask consent before connecting each source, then verify with `npx -y askshepherd@latest status`, `npx -y askshepherd@latest shepherd_wiki_status`, and `npx -y askshepherd@latest tools --json`.
|
|
19
19
|
```
|
|
20
20
|
|
|
21
21
|
The default command starts onboarding. It authenticates the Shepherd account,
|
|
@@ -26,6 +26,8 @@ After install, use the `shepherd` command:
|
|
|
26
26
|
|
|
27
27
|
```sh
|
|
28
28
|
npx -y askshepherd@latest agent-setup
|
|
29
|
+
shepherd guide
|
|
30
|
+
shepherd troubleshoot
|
|
29
31
|
shepherd login
|
|
30
32
|
shepherd onboard
|
|
31
33
|
shepherd continue
|
|
@@ -44,6 +46,12 @@ One-line agent setup:
|
|
|
44
46
|
npx -y askshepherd@latest agent-setup
|
|
45
47
|
```
|
|
46
48
|
|
|
49
|
+
Agent-facing onboarding workflow:
|
|
50
|
+
|
|
51
|
+
```sh
|
|
52
|
+
shepherd guide
|
|
53
|
+
```
|
|
54
|
+
|
|
47
55
|
Interactive first run:
|
|
48
56
|
|
|
49
57
|
```sh
|
|
@@ -54,13 +62,22 @@ Agent-led setup:
|
|
|
54
62
|
|
|
55
63
|
```sh
|
|
56
64
|
shepherd login
|
|
57
|
-
shepherd onboard --name "<full_name>" --org "<organization>" --sources google,notion,slack,granola,messages,coding-sessions
|
|
65
|
+
shepherd onboard --name "<full_name>" --org "<organization>" --sources google,notion,slack,github,granola,messages,coding-sessions
|
|
58
66
|
shepherd continue
|
|
59
67
|
shepherd status
|
|
60
68
|
```
|
|
61
69
|
|
|
62
70
|
`shepherd continue` resumes after browser auth, Google Workspace delegation,
|
|
63
|
-
Granola key entry, Messages chat selection, or
|
|
71
|
+
GitHub PAT/repository entry, Granola key entry, Messages chat selection, or
|
|
72
|
+
local sync setup. GitHub OAuth is tools-only; use `--github-token` and
|
|
73
|
+
`--github-repo` with `shepherd continue` when GitHub needs webhook-backed event
|
|
74
|
+
sync coverage.
|
|
75
|
+
|
|
76
|
+
If the agent is blocked or unsure which step is next, run:
|
|
77
|
+
|
|
78
|
+
```sh
|
|
79
|
+
shepherd troubleshoot
|
|
80
|
+
```
|
|
64
81
|
|
|
65
82
|
## Tool Calls
|
|
66
83
|
|
|
@@ -114,9 +131,17 @@ Install it into Codex:
|
|
|
114
131
|
shepherd skill --install codex
|
|
115
132
|
```
|
|
116
133
|
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
134
|
+
Install it into Claude Code, or both Codex and Claude Code:
|
|
135
|
+
|
|
136
|
+
```sh
|
|
137
|
+
shepherd skill --install claude
|
|
138
|
+
shepherd skill --install all
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
The skill is usage-focused: it teaches agents how to check setup and wiki
|
|
142
|
+
readiness, use exact Shepherd tools, avoid local filesystem probing for
|
|
143
|
+
Shepherd setup, and handle broad memory questions with iMessage-agent-style
|
|
144
|
+
evidence behavior. Onboarding instructions come from `shepherd guide`.
|
|
120
145
|
|
|
121
146
|
## Runtime Internals
|
|
122
147
|
|