@firatcand/roster 1.0.0 → 1.0.2

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 CHANGED
@@ -34,7 +34,7 @@
34
34
  npx @firatcand/roster install
35
35
  ```
36
36
 
37
- Detects Claude Code, Codex CLI, and Gemini, then copies skills + agents into each tool's config dir. macOS, Linux, and Windows.
37
+ Interactive — prompts for which AI tools to set up (Claude Code, Codex CLI, Gemini) and which scope (workspace-local vs. user home). Run inside a `roster init` workspace to get the project-local default; run from anywhere else for user-scope. macOS, Linux, and Windows. For non-interactive contexts (CI / scripts), add `--yes` plus `--tool <name>` and `--scope <project|user>` to skip prompts.
38
38
 
39
39
  ## Setup prompt
40
40
 
@@ -54,6 +54,7 @@ The agent reads [install.md](install.md), runs the install, scaffolds your works
54
54
  ```bash
55
55
  mkdir my-team && cd my-team
56
56
  npx @firatcand/roster init my-team # scaffold workspace (config/, guidelines/, function dirs)
57
+ npx @firatcand/roster install # NOW install — defaults to project scope inside a workspace
57
58
  $EDITOR config/project.yaml # fill workspace identity (stage, audience, motion)
58
59
  $EDITOR guidelines/voice.md # plus messaging.md, brand-book.md, icps/<persona>.md
59
60
  cp templates/env.example .env # then chmod 600 .env and fill secrets
@@ -61,7 +62,7 @@ claude # or `codex`, or open Cursor
61
62
  /chief-of-staff create-agent gtm sdr
62
63
  ```
63
64
 
64
- The guided dialogue reads your `config/project.yaml` + `guidelines/` and interviews you for the gaps a stub can't fill — subagents, tools, plan names, failure modes — then writes a populated `agent.md`. Worked example in [docs/HOWTO.md](docs/HOWTO.md).
65
+ `roster install` lands skills + agents under `<workspace>/.claude/`, `<workspace>/.codex/`, and/or `<workspace>/.gemini/` — workspace-local, self-contained, no cross-project pollution. The guided dialogue then reads your `config/project.yaml` + `guidelines/` and interviews you for the gaps a stub can't fill — subagents, tools, plan names, failure modes — then writes a populated `agent.md`. Worked example in [docs/HOWTO.md](docs/HOWTO.md).
65
66
 
66
67
  ### Common commands
67
68
 
@@ -91,13 +92,15 @@ A nightly **reinforcement** pass (the `dreamer` skill) reads runs + feedback, de
91
92
 
92
93
  ## Tool support
93
94
 
94
- | Tool | Status | Skills | Agents |
95
+ | Tool | Status | Project-scope skills | User-scope skills |
95
96
  |---|---|---|---|
96
- | Claude Code | Supported | `~/.claude/skills/<skill>/` | `~/.claude/agents/<agent>.md` |
97
- | Codex CLI | Supported | `~/.codex/skills/<skill>/` | `~/.codex/agents/<agent>.md` |
98
- | Gemini CLI | Supported | `~/.gemini/extensions/<skill>/` | `~/.gemini/agents/<agent>.md` |
97
+ | Claude Code | Supported | `<workspace>/.claude/skills/<skill>/` | `~/.claude/skills/<skill>/` |
98
+ | Codex CLI | Supported | `<workspace>/.codex/skills/<skill>/` | `~/.codex/skills/<skill>/` |
99
+ | Gemini CLI | Supported | `<workspace>/.gemini/extensions/<skill>/` | `~/.gemini/extensions/<skill>/` |
99
100
  | Cursor | On the roadmap | — | — |
100
101
 
102
+ Agents land in the matching `agents/` sibling of the skills dir for each tool. Project scope (default inside a roster workspace) keeps everything self-contained; user scope writes to your home directory and is visible to every project on the machine. `roster doctor` warns when the same skill name exists at both scopes — the user-scope copy wins, silently shadowing the workspace one.
103
+
101
104
  Detection is presence-only — roster considers a tool installed if its config root exists. Override via `ROSTER_CLAUDE_HOME` / `ROSTER_CODEX_HOME` / `ROSTER_GEMINI_HOME` (used by the test suite).
102
105
 
103
106
  ---