vercel-account-manager 0.1.0 → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 breadoncee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,23 +1,55 @@
+<img src="https://raw.githubusercontent.com/breadoncee/vercel-account-manager/main/assets/logo.svg" width="64" height="64" alt="vcm pixel logo">
+
 # vcm
 
-`vcm` is a small account and team manager for the [Vercel CLI](https://vercel.com/docs/cli). It gives separate Vercel logins names, remembers a global default account, and can pin an account and team to a project.
+Manage multiple [Vercel CLI](https://vercel.com/docs/cli) accounts and teams. Set a global default, or pin an account and team to a project with `.vcmrc`.
+
+[npm](https://www.npmjs.com/package/vercel-account-manager) · [Releases](https://github.com/breadoncee/vercel-account-manager/releases) · [MIT license](LICENSE)
 
-## Install with npm
+## Quick start
 
-Install the [Vercel CLI](https://vercel.com/docs/cli) first, then install `vcm` from npm:
+Install the Vercel CLI and [`vercel-account-manager` from npm](https://www.npmjs.com/package/vercel-account-manager):
 
 ```sh
 npm install -g vercel
 npm install -g vercel-account-manager
 ```
 
-The package exposes the `vcm` command on macOS and Linux. You can also install directly from [GitHub](https://github.com/breadoncee/vercel-account-manager) with `npm install -g github:breadoncee/vercel-account-manager`.
+If you are already logged in to Vercel, keep that login as `personal`. Add a second account with a one-time login, then choose the default and pin a team to a project:
+
+```sh
+vcm add personal --default
+vcm add work
+vcm use --global personal
+
+cd my-project
+vcm use work my-team
+vcm status
+vcm deploy
+```
+
+The package exposes `vcm` on macOS and Linux. Replace `work`, `my-team`, and `my-project` with your names.
+
+![Terminal example showing global account selection, a project account and team, and status](https://raw.githubusercontent.com/breadoncee/vercel-account-manager/main/assets/demo.gif)
+
+The project selection lives in `.vcmrc`. Other projects keep using your global default.
+
+## How selection works
+
+| Where you run a command | Account and team used |
+| --- | --- |
+| In a project with `.vcmrc` | The account and optional team in the closest `.vcmrc` |
+| Elsewhere | The global default account and that account's Vercel CLI default team |
+
+An explicit `--scope` or `--team` on a Vercel command takes precedence over a project's team setting.
 
 ## Install from a clone
 
 Clone this repository and run:
 
 ```sh
+git clone https://github.com/breadoncee/vercel-account-manager.git
+cd vercel-account-manager
 ./install.sh
 ```
 
@@ -29,7 +61,7 @@ export PATH="$HOME/.local/bin:$PATH"
 
 To update a previous installation after pulling changes, run `./install.sh --force`. Set `VCM_INSTALL_DIR` to an absolute path if you prefer a different installation directory.
 
-## Add accounts
+## Manage accounts
 
 If you are already logged in with the Vercel CLI, register that login without authenticating again:
 
@@ -51,7 +83,7 @@ vcm add work "$HOME/.config/vercel-work"
 
 Use `vcm login work` if you need to refresh that account's login later.
 
-## Use an account and team for a project
+## Pin an account and team to a project
 
 From the project directory, run:
 
@@ -72,7 +104,7 @@ Commands run in that directory or its subdirectories use this account and team a
 
 Remove the project's `.vcmrc` when you want it to use the global fallback again.
 
-Project team selection is passed to Vercel as `--scope` for each command, so it does not change the account's global team. Explicit `--scope` or `--team` flags on a command take precedence. An account can also be pinned without a team using `vcm use work`; in that case Vercel's default team for that account applies.
+Project team selection is passed to Vercel as `--scope` for each command, so it does not change the account's global team. An account can also be pinned without a team using `vcm use work`; in that case Vercel's default team for that account applies.
 
 ## Set the global fallback
 
@@ -119,3 +151,11 @@ sh tests/run.sh
 ```
 
 The test uses a fake `vercel` command; it does not access your accounts.
+
+## Contributing
+
+Bug reports and pull requests are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for setup, tests, and contribution guidelines.
+
+## License
+
+MIT. See [LICENSE](LICENSE).

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "vercel-account-manager",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Switch Vercel CLI accounts and teams with project-specific defaults",
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/breadoncee/vercel-account-manager.git"
@@ -16,7 +17,8 @@
   },
   "files": [
     "bin/vcm",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "os": [
     "darwin",