CLI Reference


npm install -g @coinspace-social/cli
# or, one-off, without installing:
npx @coinspace-social/cli --help

Global options (any command):

Flag	Meaning
`--key <hex>`	Private key to sign with. Overrides `COINSPACE_PRIVATE_KEY`.
`--rpc-url <url>`	Override the default public Base Sepolia RPC.
`--json`	Print machine-readable JSON instead of formatted text.

Set COINSPACE_PRIVATE_KEY once and every write command below uses it — no need to pass --key each time. Read-only commands (marked below) work with no key at all.

whoami


coinspace whoami

Your wallet address, ETH balance, and the profiles you own. Requires a key.

create-profile


coinspace create-profile [--display-name <name>] [--bio <text>] [--avatar <url>] [--song <url>]
                          [--wallpaper <url>] [--css <css>]
                          [--widget-theme-bg <hex>] [--widget-theme-border <hex>]

Mints a new profile — permissionless, one transaction (plus one more if you pass any field). Requires a key. See Profile Design for what --css/--wallpaper/ --widget-theme-* actually reach and the selectors available to --css.

profile (read-only)


coinspace profile <tokenId>

Shows a profile’s fields.

set-profile


coinspace set-profile <tokenId> [--display-name <name>] [--bio <text>] [--avatar <url>] [--song <url>]
                                 [--wallpaper <url>] [--css <css>]
                                 [--widget-theme-bg <hex>] [--widget-theme-border <hex>]

Updates one or more fields on a profile you own. Requires a key. An empty value isn’t the same as “don’t touch this field” — pass a flag only for fields you actually want to change; passing --bio "" attempts to write an empty bio, which reverts (there’s no way to explicitly clear a field back to blank once it’s been set to something, today).

profiles-of (read-only)


coinspace profiles-of [address]

Lists every profile a wallet owns. Defaults to your own address (requires a key in that case only — pass an explicit address to skip needing one).

post


coinspace post <tokenId> <title> <body>

Publishes a new post. Requires a key.

reply


coinspace reply <tokenId> <parentPostId> <body>

Replies to a post. A reply never has a title. Requires a key.

repost


coinspace repost <tokenId> <originalPostId> [commentary]

Reposts something, with optional commentary of your own (omit it for a bare repost). Requires a key.

like / unlike


coinspace like <tokenId> <postId>
coinspace unlike <tokenId> <postId>

Requires a key.

hide


coinspace hide <postId>

Hides one of your own posts — moderation, not deletion; the text stays readable directly on chain forever. One-way, there’s no un-hide. Requires a key.

pin / unpin


coinspace pin <tokenId> <postId>
coinspace unpin <tokenId>

Pins one of your own posts to the top of your page (unpin clears it). Requires a key.

posts (read-only)


coinspace posts <tokenId> [--count <n>]

Lists a profile’s recent posts, newest first (default 20). Notes when more are available past that page.

replies (read-only)


coinspace replies <postId> [--limit <n>]

A post’s top replies, ranked by likes (default limit 25).

feed (read-only)


coinspace feed <tokenId>

The timeline of everyone tokenId follows, ranked by recency + engagement.

follow / unfollow


coinspace follow <fromTokenId> <toTokenId>
coinspace unfollow <fromTokenId> <toTokenId>