social-hook CLI Reference¶

Automated social media content from development activity.

Global Options¶

These options can be placed before any command.

Options:

Flag	Type	Default	Description
`--config`, `-c`	path		Override config location
`--dry-run`	boolean	false	Run full pipeline without posting or DB writes (for testing)
`--verbose`, `-v`	boolean	false	Verbose output
`--json`	boolean	false	JSON output for scripting

Group	Description
`account`	Manage OAuth-authenticated platform accounts (X, LinkedIn).
`arc`	Manage narrative arcs.
`bot`	Bot daemon management.
`brief`	View and edit the project brief used by the evaluator and drafter.
`config`	View and modify configuration.
`content`	Submit content ideas, combine topics, and trigger hero launch drafts.
`credentials`	Manage API keys and secrets in ~/.social-hook/.env.
`cycles`	Inspect evaluation cycle history and per-strategy outcomes.
`decision`	Decision management.
`draft`	Draft lifecycle management.
`inspect`	Inspect system state.
`journey`	Development Journey capture.
`logs`	Log queries, tailing, and health.
`manual`	Manual operations.
`media`	Media management.
`memory`	Manage voice memories.
`project`	Project management.
`snapshot`	DB snapshot management.
`strategy`	View and customize content strategies (voice, audience, editorial rules).
`target`	Configure where content is distributed (account + destination + strategy).
`topics`	Manage the prioritised content topic queue per strategy.

Command	Description
`consolidation-tick`	Process held decisions — commits not post-worthy alone but interesting together.
`discover`	Analyse your repo with LLM-powered two-pass discovery.
`events`	Watch live pipeline events (commits, decisions, drafts).
`help`	Show command help. Use --json for machine-readable output.
`init`	Initialize social-hook (create directories and database).
`quickstart`	Run the quickstart flow.
`rate-limits`	Show current rate limit status (daily cap, gap timer, queue, cost).
`scheduler-tick`	Post scheduled drafts whose time has arrived and promote deferred drafts.
`setup`	Configure social-hook.
`test`	Test commit evaluation.
`trigger`	Run the full evaluation-to-draft pipeline for a single commit.
`version`	Show version information.
`web`	Start the web dashboard for managing your social-hook workflow visually.