inscope 0.8.5 → 0.8.6

package/README.md

@@ -27,7 +27,7 @@ Nothing sensitive is written to disk: GitHub tokens come from the `gh` keyring a
 
 ### Table of Contents
 
-- [Install](#-install)
+- [Quick Usage](#-quick-usage)
 - [Requirements](#-requirements)
 - [Commands](#-commands)
   - [`inscope init`](#inscope-init)
@@ -41,41 +41,40 @@ Nothing sensitive is written to disk: GitHub tokens come from the `gh` keyring a
 - [What It Manages](#-what-it-manages)
 - [MCP Servers](#-mcp-servers)
 - [Config File](#-config-file)
+- [Install Globally (Optional)](#-install-globally-optional)
 - [Contributing](#-contributing)
 
 ---
 
-## 🚀 Install
+## 🚀 Quick Usage
 
-Install globally (the CLI manages your shell hook, so a global install is expected):
-
-```sh
-npm i -g inscope
-```
-
-Scoping GitHub accounts? Sign each one into `gh` once with `gh auth login` (that is gh's own command, not inscope); inscope reads tokens from the accounts you have signed in. Then:
+No install required, just prefix any command with `npx`:
 
 ```sh
 # set up the config + hook, and source it from ~/.zshrc
-inscope init
+npx inscope init
 
 # map a workspace - inscope walks you through gh account, git identity, and servers
-inscope add ~/acme
-inscope add ~/personal
+npx inscope add ~/acme
+npx inscope add ~/personal
 
 # reload your shell, then verify
 source ~/.zshrc
-inscope doctor
+npx inscope doctor
 ```
 
+Scoping GitHub accounts? Sign each one into `gh` once with `gh auth login` (that is gh's own command, not inscope); inscope reads tokens from the accounts you have signed in.
+
 `cd ~/acme/api` and you are the work account, with work MCP servers and your work commit email. `cd ~/personal/blog` and you are you. Launch `claude` from inside a mapped directory (or relaunch) to pick up the identity.
 
 Prefer flags or CI? Every prompt has a flag, and `-y` takes the defaults non-interactively:
 
 ```sh
-inscope add ~/acme --gh <account> --email you@work.com --servers github,linear -y
+npx inscope add ~/acme --gh <account> --email you@work.com --servers github,linear -y
 ```
 
+Running these a lot? Drop the `npx` with a [global install](#-install-globally-optional).
+
 ---
 
 ## 🧰 Requirements
@@ -224,7 +223,7 @@ Each enabled server is written into the workspace `.mcp.json` with a name suffix
 Slack is opt-in. Enable it during `add` (shown above), or with flags, then store the token once:
 
 ```sh
-inscope add ~/acme --gh neeraj-acme-org --servers github,slack --seed-slack
+npx inscope add ~/acme --gh neeraj-acme-org --servers github,slack --seed-slack
 ```
 
 `--seed-slack` prompts for the `xoxp` token and writes it to the Keychain. Pass `--slack-message` to allow the Slack MCP server to post messages.
@@ -264,6 +263,17 @@ Edit it directly, then run `inscope apply` to regenerate the hook, git includes,
 
 ---
 
+## 📦 Install Globally (Optional)
+
+Reaching for inscope often? Install it once and drop the `npx`:
+
+```sh
+npm i -g inscope
+inscope <command> [options]
+```
+
+---
+
 ## 🤝 Contributing
 
 Issues and pull requests are welcome. Run the tests with `bun test` and the type checks with `bun run typecheck` before opening a PR. See [CONTRIBUTING.md](./CONTRIBUTING.md) for the toolchain and architecture.

package/dist/bin/index.mjs

@@ -61,7 +61,7 @@ add-zsh-hook chpwd __inscope_resolve_identity
 __inscope_ws="__init__"          # force the first resolve, clearing any inherited token
 __inscope_resolve_identity
 `},Je=e=>{let t=o();return e===t?`$HOME`:e.startsWith(t+n.sep)?`$HOME/${e.slice(t.length+1)}`:e},Ye=()=>{let e=Je(p());return`[ -r "${e}" ] && source "${e}"`},Xe=e=>{let t=Ye();if(e.includes(t))return e;let n=e.replace(/\n*$/,``),r=`# inscope: load each workspace's tokens (GitHub, Slack) from \$PWD on every cd\n${t}`;return n.length?`${n}\n\n${r}\n`:`${r}\n`},Ze=()=>{let e=g(),t=v(e),n=Xe(t);n!==t&&y(e,n)},Qe=()=>v(g()).includes(Ye()),Q=e=>{ge(e.workspaces);let t=p();y(t,qe(e)),Ue(e),Ze();let n=[];for(let t of e.workspaces)_e(t),n.push(A(t));return{hook:t,gitconfig:e.workspaces.some(e=>e.git?.email||e.git?.name),mcp:n}},$e=O,et=e=>`SLACK_MCP_XOXP_TOKEN_${e.toUpperCase().replace(/[^A-Z0-9]+/g,`_`)}`,tt=e=>O.filter(t=>!!e[t]),nt=(e,t)=>{let n={};for(let r of O)n[r]=r===`slack`?t?{keychain:t.keychain,addMessageTool:t.addMessageTool}:!1:e.includes(r);return n},rt=e=>e?`global: ${e}`:`no global set`,it=e=>{let t=x()?S():b(),n=t.workspaces.find(t=>t.name===e.name),r=le(t,e);C(r),Q(r),n&&u(n.path)!==u(e.path)&&ve(n)},at=async(e,t)=>{if(!e.servers.slack)return;let n=e.servers.slack.keychain;if(t){let e=await je(`Paste the Slack xoxp token for ${n}: `);e?(we(n,e),console.log(`\n✓ stored ${n} in the macOS keychain`)):console.error(`
-No token entered; skipped keychain write.`)}else F(n)||console.log(`\nSlack token not in the keychain yet. Store it once with:\n${R(Te(n))}\n\nSetup guide: ${R(De(`https://github.com/korotovsky/slack-mcp-server/blob/HEAD/docs/01-authentication-setup.md#option-2-using-slack_mcp_xoxp_token-user-oauth`))}`)};var $=`inscope`,ot=`0.8.5`,st={name:`Neeraj Dalal`,email:`admin@nrjdalal.com`,url:`https://nrjdalal.com`};const ct=`Map a directory to a GitHub account, git email, and MCP servers.
+No token entered; skipped keychain write.`)}else F(n)||console.log(`\nSlack token not in the keychain yet. Store it once with:\n${R(Te(n))}\n\nSetup guide: ${R(De(`https://github.com/korotovsky/slack-mcp-server/blob/HEAD/docs/01-authentication-setup.md#option-2-using-slack_mcp_xoxp_token-user-oauth`))}`)};var $=`inscope`,ot=`0.8.6`,st={name:`Neeraj Dalal`,email:`admin@nrjdalal.com`,url:`https://nrjdalal.com`};const ct=`Map a directory to a GitHub account, git email, and MCP servers.
 Runs interactively in a terminal; pass flags or -y to skip the prompts. Re-running
 with the same label updates that workspace; each directory maps to one workspace.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "inscope",
-  "version": "0.8.5",
+  "version": "0.8.6",
   "description": "Per-workspace identity for Claude Code: scope MCP servers, GitHub auth, and git commit identity to the directory you are in.",
   "keywords": [
     "chpwd",