@usesocial/cli 0.1.2 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # @usesocial/cli
 
+## 0.2.0
+
+### Minor Changes
+
+- [`26ca563`](https://github.com/usesocial/monorepo/commit/26ca5635ef5947a08f79d1ffc71fa926571ab0e0) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Add hidden `social <x|linkedin> sync <collection>` and `social <x|linkedin> sql` commands for a per-account local SQLite mirror. `sync` page-walks one collection (cost-estimated, gated by `--billing-limit`, default $10; `--since` windows incremental collections), `sql` runs read-only SQL or prints the schema. The commands remain invokable directly, but stay out of provider help while the cache surface settles. Live reads are unchanged.
+
+### Patch Changes
+
+- [`83650e6`](https://github.com/usesocial/monorepo/commit/83650e6f77b94d5cd4a3a5ec673164ff103d6573) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Price every proxy call from the scraped X price list (mirrored for LinkedIn) against a single `usage_credits` balance, fixing a 10–40× write overcharge that mapped non-DM writes to the most expensive category. `account usage` and `account logs` now report cost in credits, and repeated X reads served from cache no longer recharge.
+
+- [`df52bf7`](https://github.com/usesocial/monorepo/commit/df52bf795e39c333d25b0618cedc047ad6f14b24) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Limit `--no-cache` to generated commands backed by cacheable proxy reads so non-cacheable DM, message, timeline, bookmark, and write commands no longer send misleading cache-control headers.
+
+- [`83650e6`](https://github.com/usesocial/monorepo/commit/83650e6f77b94d5cd4a3a5ec673164ff103d6573) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Reshape the root command surface to `account · schema · x · linkedin` and fold the old `auth` and `accounts` groups into one `account` command: bare `social account` prints the auth state plus connected accounts, with `login`, `logout`, `connect`, `reconnect`, `disconnect`, `usage`, `logs`, and `config` (including `config cache mode|ttl`) as subcommands. `account usage` shows the billing overview and `account logs` lists recent proxy calls. Own-account commands now infer the X account ID instead of requiring it, and account selectors carry reconnect hints.
+
+- [`1a6461e`](https://github.com/usesocial/monorepo/commit/1a6461e39dc02640948de49b26b13e3ba3c1bc4b) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Rewrite generated provider help and schema descriptions to show summary, capability, and runnable usage instead of internal HTTP routes.
+
+- [`83650e6`](https://github.com/usesocial/monorepo/commit/83650e6f77b94d5cd4a3a5ec673164ff103d6573) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Unify identifier positionals across X and LinkedIn into one explicit `target` grammar: every command accepts an `@handle`, a profile/post/status URL, a typed `kind:id` reference (e.g. `chat_id:…`, `request_id:…`), or `me`. Pure-parse targets resolve for free; `@handle` lookups are cached and reported under `meta.resolved` with a `source`. Writes return openable URLs and audit-friendly IDs, and read envelopes carry richer default payloads.
+
+- [`a93af9c`](https://github.com/usesocial/monorepo/commit/a93af9cdbde74f6552cba9e465425526d4f5ddcc) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Limit account connect and reconnect JSON output to the connected account details.
+
+- [`26ca563`](https://github.com/usesocial/monorepo/commit/26ca5635ef5947a08f79d1ffc71fa926571ab0e0) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Hide the LinkedIn `search` group from `social linkedin --help` (still invokable).
+
+- [`1893cc5`](https://github.com/usesocial/monorepo/commit/1893cc5d715ffde41b83f7f9822f7b3aca0a305a) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Send LinkedIn inbox mark-read and mark-unread writes with Unipile's current `read_status` body, and keep legacy installed CLIs working through a proxy-side body transform.
+
+- [`83650e6`](https://github.com/usesocial/monorepo/commit/83650e6f77b94d5cd4a3a5ec673164ff103d6573) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Add edit and delete write verbs to the LinkedIn inbox — `linkedin message <chat> edit message_id:<id> <text>` and `linkedin message <chat> delete message_id:<id>` — alongside `linkedin messages <chat> mark <status>` for read-status. Delete requires confirmation and now correctly meters its `204 No Content` response as one billed write instead of advertising a cost it never charged.
+
+- [`5278a68`](https://github.com/usesocial/monorepo/commit/5278a68e436523d2f910b1e9e065efc3f20fbfc3) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Cap `linkedin messages --limit` at 20 for inbox conversation lists so the CLI fails locally instead of sending provider-rejected LinkedIn inbox requests.
+
+- [`83650e6`](https://github.com/usesocial/monorepo/commit/83650e6f77b94d5cd4a3a5ec673164ff103d6573) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Add the full LinkedIn relation-request lifecycle under a `requests` group: `requests send <target> [message]` (renamed from the old root `connect`), `requests sent`, `requests received`, `requests accept request_id:<id>`, and `requests cancel request_id:<id>`.
+
+- [`83650e6`](https://github.com/usesocial/monorepo/commit/83650e6f77b94d5cd4a3a5ec673164ff103d6573) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Refresh the LinkedIn surface with richer profiles: `linkedin profile` defaults to `about,experience,education`, reads embed inline author cards, `linkedin connections` routes through the supported connections endpoint, and cache-control flags are honored on cacheable reads.
+
+- [`2483598`](https://github.com/usesocial/monorepo/commit/2483598ba0e471a1a0bb7c8819dae158005d0b28) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Replace cacheable-read `--no-cache` with repeatable `--header`/`-H` request headers, including `Cache-Control` overrides for proxy cache freshness.
+
+- [`83650e6`](https://github.com/usesocial/monorepo/commit/83650e6f77b94d5cd4a3a5ec673164ff103d6573) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Expand the X read surface with six new commands — `x likers`, `x quotes`, `x reposters`, `x liked`, `x mentions`, and `x profile` (fetch any profile by target, not just your own) — and unify direct messages into `x messages` (list or read a thread) plus a single `x message <target> <text>` send verb. Read payloads now inline data already paid for, including DM sender identity, via default field presets.
+
 ## 0.1.2
 
 ### Patch Changes

package/README.md

@@ -23,18 +23,16 @@ Published as `@usesocial/cli` on npm; the binary is `social`.
 
 ```sh
 curl -fsSL https://usesocial.dev/install.sh | bash
-# or install only the CLI with Homebrew
-brew install usesocial/tap/cli
 ```
 
 ## Quickstart
 
 ```sh
-social auth login                       # device sign-in, choose scope, set up billing
-social accounts connect linkedin        # connect a LinkedIn account
-social linkedin whoami
-social accounts connect x               # connect an X account
-social x whoami
+social account login                    # device sign-in, choose scope, set up billing
+social account connect linkedin         # connect a LinkedIn account
+social linkedin profile
+social account connect x                # connect an X account
+social x profile
 ```
 
 ## What you can hand your agent
@@ -44,121 +42,131 @@ A few of the things the command surface supports:
 
 | You ask | The agent reaches for |
 |---|---|
-| "Surface the ten connections worth reaching out to this week." | `linkedin users connections`, `x users tweets` |
-| "Pull everyone who reacted to my last LinkedIn post and flag the warm leads." | `linkedin posts reactions`, `linkedin users get` |
-| "Read this creator's recent posts and break down what makes them land." | `linkedin users posts`, `x users tweets` |
-| "Find what people are saying about AI agents this week and summarize the themes." | `linkedin search posts`, `x search recent` |
-| "Draft a reply to this thread and post it once I approve." | `linkedin posts comment`, `x tweets post` |
+| "Surface the ten connections worth reaching out to this week." | `linkedin connections`, `x tweets` |
+| "Pull everyone who reacted to my last LinkedIn post and flag the warm leads." | `linkedin reactions`, `linkedin profile` |
+| "Read this creator's recent posts and break down what makes them land." | `linkedin posts`, `x tweets` |
+| "Find what people are saying about AI agents this week and summarize the themes." | `linkedin search posts`, `x timeline` |
+| "Draft a reply to this thread and post it once I approve." | `linkedin comment`, `x post` |
 
 ## Commands
 
-The main command surfaces print compact JSON by default. Most accept filters like
-`--limit`, `--cursor`, `--from`, and `--to`. Pass `--help` on any subcommand for
-the full flag list, or run `social schema` for a structured dump of every command
-— handy as an agent manifest.
+The main command surfaces print compact JSON by default. List commands commonly
+accept `--limit` and `--cursor`; time windows are command-specific. Pass `--help`
+on any subcommand for the full flag list, or run `social schema "<command path>"`
+for the machine-readable contract for a runnable command. Agents planning across
+many calls can run `social schema --leaves` for a manifest of runnable commands
+keyed by command path.
 
 Commands marked **✎ write** mutate your account and require an explicit write
 scope (see [Account safety](#account-safety)).
 
+### Targets
+
+Commands with `[target]` or `<target>` accept `@handle` or `@public-identifier`,
+a full X/LinkedIn URL, a LinkedIn URN, or a typed ID such as `profile_id:<id>`,
+`post_id:<id>`, `list_id:<id>`, `chat_id:<id>`, `company_id:<id>`, or `request_id:<id>`. Bare IDs are not
+accepted. When an optional target is omitted, the command acts on your own
+connected account.
+
 ### Top level
 
 | Command | Description |
 |---|---|
-| `social config` | Read or configure local CLI settings. |
-| `social auth login` | Device sign-in, scope selection, and billing. |
-| `social auth logout` | Revoke the session and clear the saved token. |
-| `social accounts <…>` | Connect, reconnect, disconnect, and list accounts. |
-| `social schema` | Print the full command tree as JSON — a manifest for agents. |
-| `social usage` | Recent calls or an aggregate billing/usage summary. |
-| `social linkedin <…>` | LinkedIn operations (below). |
+| `social account` | Show auth state and connected accounts; login, logout, connect accounts, inspect usage/logs, and configure local CLI settings. |
+| `social schema` | Print the compact command tree, inspect one command with `social schema "<command path>"`, or emit agent command contracts with `social schema --leaves`. |
 | `social x <…>` | X operations (below). |
+| `social linkedin <…>` | LinkedIn operations (below). |
 
-### `social accounts`
+### `social account`
 
 | Command | Description | |
 |---|---|---|
-| `connect linkedin` | Connect a LinkedIn account through hosted auth. | ✎ write |
+| `(bare)` | Show who is signed in and list connected accounts. | |
+| `login` | Device sign-in, scope selection, and billing. | |
+| `logout` | Revoke the session and clear the saved token. | |
+| `connect linkedin` | Connect a LinkedIn account through the browser. | ✎ write |
 | `connect x` | Connect an X account through OAuth. | ✎ write |
 | `reconnect linkedin <account>` | Re-auth an existing LinkedIn account. | ✎ write |
 | `reconnect x <account>` | Re-auth an existing X account. | ✎ write |
 | `disconnect linkedin <account>` | Disconnect a LinkedIn account. | ✎ write |
 | `disconnect x <account>` | Disconnect an X account. | ✎ write |
-| `list [linkedin\|x\|all]` | List accounts. Defaults to all platforms. | |
+| `usage` | Aggregate proxy usage and billing stats. | |
+| `logs` | Recent proxy calls. | |
+| `config cache mode` | Read or set the cache mode preset. | |
+| `config cache ttl` | Set a custom cache TTL in seconds. | |
 
-`accounts list` returns `{ accounts: [...] }` as compact JSON.
+`social account` returns compact JSON with the signed-in user and connected accounts.
 
 ### `social linkedin`
 
 | Command | Description | |
 |---|---|---|
-| `companies get` | Fetch a company profile. | |
-| `companies employees` | List employees at a company. | |
-| `companies jobs` | List a company's job postings. | |
-| `posts get` | Fetch a post. | |
-| `posts comments` | List a post's comments. | |
-| `posts reactions` | List a post's reactions. | |
-| `posts post` | Create a post. | ✎ write |
-| `posts comment` | Comment on a post. | ✎ write |
-| `posts react` | React to a post or comment. | ✎ write |
-| `search people` | Search for people. | |
-| `search posts` | Search for posts. | |
-| `inbox list` | List LinkedIn inbox conversations. | |
-| `inbox get` | Fetch an inbox conversation. | |
-| `inbox messages` | List messages in a chat. | |
-| `inbox send` | Send a message in a chat. | ✎ write |
-| `users get` | Fetch a profile. | |
-| `users connections` | List a user's connections. | |
-| `users posts` | List a user's or company's posts. | |
-| `whoami` | Show the connected LinkedIn profile. | |
-| `users me` | Same profile read as `whoami`. | |
-| `users invite` | Send a connection invite. | ✎ write |
+| `post <text>` | Create a post. | ✎ write |
+| `comment <target> <text>` | Comment on a post. | ✎ write |
+| `react <target> [type=like]` | React to a post or comment. | ✎ write |
+| `requests send <target> [message]` | Send a connection request. | ✎ write |
+| `requests sent` | List pending sent connection requests; supports `--limit`, `--cursor`, `--offset`, and `-H/--header`. | |
+| `requests received` | List pending received connection requests; supports `--limit`, `--cursor`, `--offset`, and `-H/--header`. | |
+| `requests accept request_id:<id>` | Accept a received connection request. | ✎ write |
+| `requests cancel request_id:<id>` | Cancel a sent request or refuse a received connection request. | ✎ write |
+| `posts [target]` | List a user's or company's posts; omit the target for your own account. | |
+| `comments <target>` | List a post's comments. | |
+| `reactions <target>` | List a post's reactions. | |
+| `profile [target]` | Fetch a profile; omit the target for your own account. | |
+| `connections [target]` | List connections; omit the target for account-level connections. | |
+| `company <target>` | Fetch a company profile. | |
+| `jobs <target>` | List a company's job postings. | |
+| `search people <keywords>` | Search for people. | |
+| `search posts <keywords>` | Search for posts. | |
+| `search jobs <keywords>` | Search for jobs. | |
+| `search companies <keywords>` | Search for companies. | |
+| `messages` | List conversations. | |
+| `messages <target>` | Read a conversation by `chat_id:<id>`, `@handle`, `profile_id:<id>`, profile URL, or messaging-thread URL. | |
+| `message <target> <text>` | Send a message. | ✎ write |
+| `message <target> delete message_id:<id>` | Delete one of your own messages. | ✎ write |
+| `message <target> edit message_id:<id> <text>` | Edit one of your own messages. | ✎ write |
+| `messages <target> mark read` | Mark a conversation read. | ✎ write |
+| `messages <target> mark unread` | Mark a conversation unread. | ✎ write |
 
 ### `social x`
 
 | Command | Description | |
 |---|---|---|
-| `search recent` | Search posts from the last 7 days. | |
-| `timelines home` | Read the home timeline. | |
-| `tweets list` | Fetch up to 100 posts by ID. | |
-| `tweets get` | Fetch a single post by ID. | |
-| `tweets post` | Create a post. | ✎ write |
-| `tweets like` · `unlike` | Like or unlike a post. | ✎ write |
-| `tweets repost` · `unrepost` | Repost or undo a repost. | ✎ write |
-| `tweets delete` | Delete a post. | ✎ write |
-| `users tweets` | List a user's recent posts. | |
-| `users followers` | List a user's followers. | |
-| `users following` | List accounts a user follows. | |
-| `whoami` | Show the authenticated X profile. | |
-| `users me` | Same profile read as `whoami`. | |
-| `users follow` · `unfollow` | Follow or unfollow a user. | ✎ write |
-| `bookmarks list` | List your saved bookmarks. | |
-| `bookmarks add` · `remove` | Add or remove a bookmark. | ✎ write |
-| `dms list` | List recent DM events. | |
-| `dms messages` | List DM events for a conversation. | |
-| `dms with` | List one-to-one DM events with a user. | |
-| `dms get` | Fetch a DM event. | |
-| `dms start` | Start a DM conversation. | ✎ write |
-| `dms send` | Send a DM to a participant or conversation. | ✎ write |
+| `post <text>` | Create a post. | ✎ write |
+| `repost <target>` · `unrepost <target>` | Repost or undo a repost. | ✎ write |
+| `like <target>` · `unlike <target>` | Like or unlike a post. | ✎ write |
+| `follow <target>` · `unfollow <target>` | Follow or unfollow a user. | ✎ write |
+| `followers [target]` | List a user's followers; omit the target for your own account. | |
+| `following [target]` | List accounts a user follows; omit the target for your own account. | |
+| `tweet <target>` | Fetch a single post. | |
+| `tweets [target]` | List a user's recent posts; omit the target for your own account. | |
+| `profile [target]` | Fetch a profile; omit the target for your own account. | |
+| `timeline` | Read the home timeline. | |
+| `bookmark <target>` · `unbookmark <target>` | Add or remove a bookmark. | ✎ write |
+| `messages` | List conversations. | |
+| `messages <target>` | Read a DM conversation or participant target: chat URL, `chat_id:<id>`, `@handle`, profile URL, or `profile_id:<id>`. | |
+| `message <recipients> [text]` | Send a message to a chat URL, `chat_id:<id>`, `@handle`, profile URL, or `profile_id:<id>`; comma-separate profile targets for a group. | ✎ write |
 
 ## Built for agents
 
 - **Everything speaks JSON.** Pipe output through `jq`, `fzf`, or your agent's
   planner — anything that reads stdin. Structured errors and predictable exit
   codes mean an agent can branch on what happened.
-- **The same flags across networks.** `--limit`, `--cursor`, `--account`, and
-  `--no-cache` behave consistently on LinkedIn and X.
+- **The same patterns across networks.** `--limit`, `--cursor`, and `--account`
+  behave consistently on LinkedIn and X. Cacheable reads also list `-H/--header`
+  when proxy request headers such as `Cache-Control: no-cache` can be overridden.
 - **A skill you drop straight in.** Install the public skill repo with
   `npx skills add usesocial/skill`; Claude, Codex, or any other supported agent
   then knows the commands.
 
 ```sh
-# Find hiring posts, fan out to reaction graphs, rank warm contacts — one pipe.
-social linkedin search posts "AI infra hiring" \
-  | jq -r '.posts[].urn' \
-  | xargs -I{} social linkedin posts reactions {} \
-  | jq -s '[.[].reactions[] | {actor, type}]
-            | group_by(.actor.id)
-            | map({actor: .[0].actor, signals: length})
+# Find hiring posts, fan out to reaction graphs, rank warm contacts.
+social linkedin search posts "AI infra hiring" --limit 25 > /tmp/hiring-posts.json
+jq -r '.items[].id' /tmp/hiring-posts.json \
+  | xargs -I{} social linkedin reactions post_id:{} \
+  | jq -s '[ .[] | .items[] ]
+            | group_by(.actor.id // .reactor.id // .profile_id)
+            | map({person: (.[0].actor // .[0].reactor), signals: length})
             | sort_by(-.signals) | .[0:15]'
 ```
 
@@ -169,53 +177,68 @@ social linkedin search posts "AI infra hiring" \
 | `0` | Success | Continue. |
 | `2` | Usage or validation error | Fix the command, flags, IDs, JSON body, or local input. |
 | `3` | Not found | Check the resource ID or pick a different item. |
-| `4` | Auth or scope error | Run `social auth login`, or re-login with the needed scope. |
+| `4` | Auth or scope error | Run `social account login`, or log out and choose the needed scope. |
 | `5` | API or unexpected error | Retry later or surface the server error. |
 | `7` | Rate limited | Back off; JSON errors may include `retryAfterSeconds`. |
 
 ## Auth
 
-`social auth login` runs a device-authorization flow:
+`social account login` runs a device-authorization flow:
 
 1. Asks what access to grant the agent. Read and Write are both selected by
-   default; pass `--scope read` to grant read-only access.
-2. Shows you a verification code and approval URL, then tries to open that URL
+   default; clear Write in the prompt to grant read-only access.
+2. Asks for your email address.
+3. Shows you a verification code and approval URL, then tries to open that URL
    in your browser.
-3. Waits until you approve the session in the browser.
-4. Stores the returned token in your OS keyring, falling back to
+4. Waits until you approve the session in the browser.
+5. Confirms billing checkout in the terminal when a seat is needed.
+6. Stores the returned token in your OS keyring, falling back to
    `~/.social/credentials.json` (mode `0600`) when no keyring is available.
    Non-production `SOCIAL_API_URL` values use an API-specific credential
    namespace so staging tests do not overwrite the production session.
 
-`social auth logout` revokes the session and removes the stored token from both places.
-`social auth login` requires an interactive terminal and is not supported from CI,
+`social account logout` revokes the session and removes the stored token from both places.
+Bare `social account` prints compact JSON with the current auth state, credential
+namespace, verified session when available, and connected accounts.
+`social account login` requires an interactive terminal and is not supported from CI,
 background jobs, or agent-mediated setup flows.
 
 ## Cache config
 
-Allowlisted GET requests use a local proxy cache. The CLI sends
-`Cache-Control: max-age=<seconds>` on API requests from your local config:
+Allowlisted GET requests use a local proxy cache. Cacheable commands send
+`Cache-Control: max-age=<seconds>` from your local config:
 
 ```sh
-social config cache mode                  # read the current cache mode and TTL
-social config cache mode live             # 15 minutes, default
-social config cache mode analytical       # 24 hours
-social config cache mode historical       # 1 week
-social config cache ttl 3600              # custom TTL in seconds
+social account config cache mode                  # read the current cache mode and TTL
+social account config cache mode live             # 15 minutes, default
+social account config cache mode analytical       # 24 hours
+social account config cache mode historical       # 1 week
+social account config cache ttl 3600              # custom TTL in seconds
 ```
 
 Setting `ttl` switches the mode to `custom`. Config is stored at
-`~/.social/config.json` with mode `0600`. Use command-level `--no-cache` when you
-need to bypass cached reads and refresh the stored response.
+`~/.social/config.json` with mode `0600`. Use command-level
+`-H "Cache-Control: no-cache"` when a command lists `--header` in help and you
+need to bypass a cached read.
+
+Command output exposes actual per-call cost and pagination under `meta`:
+
+```sh
+social linkedin messages --limit 20 | jq '.meta.cost'
+social x bookmarks --limit 20 | jq '{cost: .meta.cost, cursor: .meta.cursor}'
+```
+
+Agents should watch `.meta.cost` during high-fanout loops and use `social account usage`
+or `social account logs` after a run to summarize actual spend.
 
 ## Account safety
 
 Built so your accounts outlive your prototype.
 
-- **Read/write scope by default.** Pass `--scope read` when you want a
-  read-only session that can't post, react, or invite.
+- **Read/write scope by default.** Clear Write during login when you want a
+  read-only session that can't post, react, or request connections.
 - **A write never fires twice.** Rate-limit and server errors surface verbatim and
-  writes are never retried — so a post or invite can't double-send.
+  writes are never retried — so a post or connection request can't double-send.
 - **A residential IP per account.** Each connected account runs over a dedicated
   residential proxy with smart rate-limiting, so the network sees a normal session.
 
@@ -224,21 +247,22 @@ Built so your accounts outlive your prototype.
 ```sh
 # LinkedIn
 social linkedin search people "founder ai"
-social linkedin whoami
+social linkedin profile
 
 # X
-social x search recent "from:elonmusk"
-social x bookmarks list <my-x-user-id> --limit 50
-social x users followers <x-user-id> --limit 100
-social x users following <x-user-id> --limit 100
-social x dms list --limit 50
+social x bookmarks --limit 50
+social x followers --limit 100
+social x following profile_id:<x-user-id> --limit 100
+social x messages --limit 50
 
 # Usage / billing
-social usage --summary --platform linkedin
-social usage --limit 20 --from 2026-05-01T00:00:00Z
+social account usage
+social account logs --limit 20 --from 2026-05-01T00:00:00Z
 
-# Agent manifest
+# Command schema
 social schema
+social schema --leaves
+social schema "x post"
 ```
 
 ## Links

package/bin/social.mjs

@@ -1,10 +1,17 @@
 #!/usr/bin/env node
+import { existsSync } from "node:fs";
 import { dirname, join } from "node:path";
+import { loadEnvFile } from "node:process";
 import { fileURLToPath, pathToFileURL } from "node:url";
 
 const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+const localEnvPath = join(packageRoot, "..", "..", ".env.staging");
 const entryURL = pathToFileURL(join(packageRoot, "dist", "index.mjs")).href;
 
+if (existsSync(localEnvPath)) {
+  loadEnvFile(localEnvPath);
+}
+
 import(entryURL).catch((error) => {
   console.error(error);
   process.exit(1);