cli: make bundled help self-describing

2026-03-22 23:37:38 +08:00
parent 5859ff219e
commit 4d8c90eb26
49 changed files with 792 additions and 29 deletions
@@ -12,6 +12,12 @@ func newInitCmd(opts *rootOptions) *cobra.Command {
 	return &cobra.Command{
 		Use:   "init",
 		Short: "Initialize the shared SQLite database schema",
+		Long: helpLong(
+			"Use init to create or migrate the shared inbox SQLite schema at one database path.",
+			"Run init once before first real use on a new database path.",
+			"init is safe to rerun when you need to ensure the schema exists before another command.",
+		),
+		Example: `  inbox --db .agents/coord.db init`,
 		RunE: func(cmd *cobra.Command, args []string) error {
 			ctx := cmd.Context()