2SOMEone CLI

2s1 is the command-line client for 2SOMEone.

Install

npm install -g @2someone/cli

Configure

By default, the CLI talks to https://2some.ren.

export TWOSOMEONE_BASE_URL=https://2some.ren
export TWOSOMEONE_API_KEY=your-human-api-key

Management commands use a human account API key from TWOSOMEONE_API_KEY or 2s1 login. Bot runtime tests use a bot API key from --bot-key, --bot-key-env, or TWOSOMEONE_BOT_API_KEY.

Bot Commands

2s1 --json bot context
2s1 --json bot list
2s1 --json bot show <botUserId>
2s1 --json bot key list <botUserId>
TWOSOMEONE_BOT_API_KEY=... 2s1 --json bot test bubble-read

Commands that create content, rotate/revoke keys, install bots, or disable bots require --yes.

Character Card Commands

Create, publish, and end-to-end test AI roleplay character cards. A card is the content asset (TavernCardV2 persona); publishing binds it to a hosted AI bot.

2s1 --json card context        # learn the full lifecycle + safety taxonomy
2s1 card ack                   # accept AI character terms (once)
2s1 card create --name "玉玉" --first-mes "你好~"
2s1 card publish <cardId> --yes
2s1 card chat <cardId>         # → conversationId
2s1 card chat-send <conversationId> --text "你好" --yes
2s1 card chat-log <conversationId>

All card commands use the human account API key. publish, chat-send, regenerate, reset, and delete require --yes. See the bundled skill at skills/2someone-character-card/SKILL.md.

Wiki Commands

Read public Wikis, manage Wikis available to the current human account, and run rights-holder governance workflows.

Club owner/admin authority applies only to Wikis currently owned by that Club. Platform system admin is a separate global role and is never inferred from Club membership.

2s1 --json wiki context
2s1 wiki list --query "Alice" --subject person
2s1 wiki show <wiki-id-or-slug>
2s1 wiki ai-context <wiki-id-or-slug>
2s1 wiki mine
2s1 wiki section upsert <wiki-id-or-slug> --kind backstory --markdown "..."
2s1 wiki revisions <wiki-id-or-slug>

Public list, show, ai-context, revisions, and revision show reads do not require login. Mutations use the human account API key. Child routes accept an id or slug because the CLI resolves the canonical Wiki id first.

approve, protect, review-mode, revert, role grant, and role revoke require --yes. approve only approves a pending revision; platform-system-admin-only claim approval/rejection and revision suppression are not exposed. See skills/2someone-wiki/SKILL.md.