dynamoi 0.2.2 → 0.2.3

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
@@ -5,77 +5,88 @@
5
5
  [![npm version](https://img.shields.io/npm/v/dynamoi?label=npm)](https://www.npmjs.com/package/dynamoi)
6
6
  [![license](https://img.shields.io/npm/l/dynamoi)](./LICENSE)
7
7
 
8
- The command line for [Dynamoi](https://dynamoi.com): music promotion that works
9
- with any distributor. Run real Spotify and YouTube ad campaigns, and see what
10
- each one moved. Smart Links, analytics and growth audits are free. Artists who
11
- want everything in one account can also release to 100+ stores through Dynamoi.
12
- Use it from a terminal, a script or an agent that can run shell commands.
8
+ The `dynamoi` command line runs [Dynamoi](https://dynamoi.com) music promotion
9
+ from a terminal, a script or any agent that can run shell commands. Check
10
+ campaign results, build free Smart Links, and launch Spotify and YouTube ad
11
+ campaigns, with the same account, tools and consent rules as the Dynamoi apps.
12
+ It works with any distributor.
13
13
 
14
- It is a thin client for Dynamoi's hosted MCP server at
15
- `https://dynamoi.com/mcp`, so it follows the same account, tools and consent
16
- rules as the apps. It has no tool list of its own: every command comes from the
17
- server's tool schemas, so new tools appear without an update.
14
+ <p align="center">
15
+ <img alt="Running dynamoi --help in a terminal" src="https://raw.githubusercontent.com/getDynamoi/dynamoi/main/.github/assets/cli-help.gif" width="720">
16
+ </p>
18
17
 
19
18
  ## Install
20
19
 
21
20
  ```bash
22
- npm install --global dynamoi
23
- # or run it once
24
- npx dynamoi tools
25
- ```
21
+ # npm, run once without installing
22
+ npx dynamoi --help
26
23
 
27
- Node 20 or newer.
24
+ # Homebrew (macOS and Linux)
25
+ brew trust getdynamoi/tap && brew install getdynamoi/tap/dynamoi
28
26
 
29
- ## Sign in
30
-
31
- ```bash
32
- dynamoi login # opens your browser; sign in with your Dynamoi account
33
- dynamoi whoami
34
- dynamoi logout # revokes the session and deletes stored tokens
27
+ # npm, installed globally
28
+ npm install --global dynamoi
35
29
  ```
36
30
 
37
- `dynamoi login` uses OAuth 2.1 with PKCE and a loopback redirect on
38
- `127.0.0.1`, the same sign-in as Claude Code and Codex. There are no API keys.
39
- Tokens go to your OS keychain (macOS Keychain, or the Secret Service on Linux)
40
- and fall back to a `0600` file in `$XDG_CONFIG_HOME/dynamoi` (default
41
- `~/.config/dynamoi`). Sessions refresh on their own. Because the app signs in on
42
- your own computer, it gets the Full tool set; before sign-in you see only the
43
- directory set.
31
+ Needs Node 20 or newer. Homebrew installs Node for you.
32
+
33
+ ## Commands
44
34
 
45
- ## Use
35
+ | Command | What it does |
36
+ | --- | --- |
37
+ | `dynamoi login` | Sign in through your browser |
38
+ | `dynamoi whoami` | Show the signed-in account |
39
+ | `dynamoi logout` | Revoke the session and delete stored tokens |
40
+ | `dynamoi tools` | List every tool your account can use |
41
+ | `dynamoi help <tool>` | Show one tool's flags |
42
+ | `dynamoi <tool> [--flag value]` | Run a tool. Add `--json` for machine-readable output |
46
43
 
47
44
  ```bash
48
- dynamoi tools # every tool your account can use
49
- dynamoi help get-campaign # flags for one tool
50
45
  dynamoi list-artists
51
46
  dynamoi get-artist-analytics --artist-id <id> --json
47
+ dynamoi get-growth-audit --artist-id <id>
52
48
  ```
53
49
 
54
- A command is the tool name without its `dynamoi_` prefix, with dashes. Flags come
55
- from the tool's input schema: `--artist-id` is `artistId`. Booleans are
56
- `--flag` or `--no-flag`, lists repeat the flag or take commas, and objects take a
57
- JSON string. `--input '<json>'` passes the whole argument object. `--json` prints
58
- the structured result.
50
+ A command is the tool name without its `dynamoi_` prefix, with dashes. Flags
51
+ come from the tool's input schema, so `--artist-id` is `artistId`. Booleans
52
+ take `--flag` or `--no-flag`, lists repeat the flag or take commas, objects
53
+ take a JSON string, and `--input '<json>'` passes the whole argument object.
59
54
 
60
- ## Paid and consequential actions
55
+ The CLI has no tool list of its own. Every command is generated from the
56
+ schemas of Dynamoi's hosted MCP server at `https://dynamoi.com/mcp`, so new
57
+ tools appear without an update.
61
58
 
62
- Tools that spend money or submit something on your behalf require explicit
63
- confirmation arguments (`confirm...`, `authorize...`, `accepted...`). The CLI
64
- never sets them for you:
59
+ ## How sign-in works
65
60
 
66
- - In a terminal, it shows the tool's summary and asks `[y/N]` before granting a
67
- required yes/no confirmation.
68
- - Without a terminal, such as in a script or an agent, pass the flag yourself,
69
- for example `--confirm-application-submission`.
70
- - Consent versions and hashes are always passed explicitly. Read them in
71
- `dynamoi help <tool>`.
61
+ `dynamoi login` uses OAuth 2.1 with PKCE and a loopback redirect on
62
+ `127.0.0.1`, the same sign-in as Claude Code and Codex. There are no API keys
63
+ to copy. Tokens are stored in your OS keychain (macOS Keychain, or the Secret
64
+ Service on Linux), with a `0600` file in `~/.config/dynamoi` as the fallback,
65
+ and sessions refresh on their own. Because the CLI signs in on your own
66
+ computer, it gets the full tool set.
67
+
68
+ ## Paid actions need your yes
69
+
70
+ Tools that spend money or submit something for you require explicit
71
+ confirmation arguments (`confirm...`, `authorize...`, `accepted...`), and the
72
+ CLI never fills them in for you.
72
73
 
73
- Dynamoi's server refuses the action without them. Results are never guaranteed.
74
+ - In a terminal, it shows the tool's summary and asks `[y/N]` first.
75
+ - In a script or an agent, you pass the flag yourself, for example
76
+ `--confirm-application-submission`.
77
+ - Budget consent versions and hashes are always passed explicitly. Find them
78
+ with `dynamoi help <tool>`.
79
+
80
+ Without them, Dynamoi's server refuses the action and charges nothing.
74
81
 
75
82
  ## Links
76
83
 
77
84
  - [Dynamoi](https://dynamoi.com) and [pricing](https://dynamoi.com/pricing)
78
- - [MCP server and library (`@dynamoi/mcp`)](https://github.com/getDynamoi/dynamoi)
85
+ - [MCP server and library](https://github.com/getDynamoi/dynamoi)
79
86
  - [MCP server docs](https://dynamoi.com/docs/mcp-server)
80
87
 
81
88
  MIT licensed.
89
+
90
+ ---
91
+
92
+ **Part of Dynamoi** · [MCP server](https://github.com/getDynamoi/dynamoi) · [CLI](https://github.com/getDynamoi/dynamoi/tree/main/cli) · [Agent plugins](https://github.com/getDynamoi/agent-plugins) · [Homebrew tap](https://github.com/getDynamoi/homebrew-tap) · [Chrome extension](https://github.com/getDynamoi/browser-extension) · [dynamoi.com](https://dynamoi.com) · [Docs](https://dynamoi.com/docs) · [Support](https://dynamoi.com/support)
package/dist/dynamoi.js CHANGED
@@ -3,7 +3,7 @@
3
3
  var package_default = {
4
4
  $schema: "https://www.schemastore.org/package",
5
5
  name: "dynamoi",
6
- version: "0.2.2",
6
+ version: "0.2.3",
7
7
  type: "module",
8
8
  license: "MIT",
9
9
  description: "Music promotion and distribution, built for AI agents: the Dynamoi command line.",
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://www.schemastore.org/package",
3
3
  "name": "dynamoi",
4
- "version": "0.2.2",
4
+ "version": "0.2.3",
5
5
  "type": "module",
6
6
  "license": "MIT",
7
7
  "description": "Music promotion and distribution, built for AI agents: the Dynamoi command line.",