docs: add usage examples to agent, init, and compact commands

Add Examples sections to the Long description of commands that have
meaningful flags, following the pattern established in add.go.

Signed-off-by: Jose Alekhinne <alekhinejose@gmail.com>

Author: josealekhine

internal/cli/agent.go

@@ -38,7 +38,13 @@ It includes:
   - Recent decisions
 
 Use --budget to limit token output (default 8000).
-Use --format to choose between markdown (md) or JSON output.`,
+Use --format to choose between markdown (md) or JSON output.
+
+Examples:
+  ctx agent                    # Default 8000 token budget, markdown output
+  ctx agent --budget 4000      # Smaller context packet for limited contexts
+  ctx agent --format json      # JSON output for programmatic use
+  ctx agent --budget 2000 --format json`,
 		RunE: runAgent,
 	}
 

internal/cli/compact.go

@@ -38,12 +38,27 @@ Actions performed:
   - Remove empty sections from context files
   - Report on potential duplicates
 
-Use --archive to create .context/archive/ for old content.`,
+Use --archive to create .context/archive/ for old content.
+
+Examples:
+  ctx compact                  # Clean up context, move completed tasks
+  ctx compact --archive        # Also archive old tasks to .context/archive/
+  ctx compact --no-auto-save   # Skip pre-compact session snapshot`,
 		RunE: runCompact,
 	}
 
-	cmd.Flags().BoolVar(&compactArchive, "archive", false, "Create .context/archive/ for old content")
-	cmd.Flags().BoolVar(&compactNoAutoSave, "no-auto-save", false, "Skip auto-saving session before compact")
+	cmd.Flags().BoolVar(
+		&compactArchive,
+		"archive",
+		false,
+		"Create .context/archive/ for old content",
+	)
+	cmd.Flags().BoolVar(
+		&compactNoAutoSave,
+		"no-auto-save",
+		false,
+		"Skip auto-saving session before compact",
+	)
 
 	return cmd
 }
@@ -106,7 +121,9 @@ func runCompact(cmd *cobra.Command, _ []string) error {
 	return nil
 }
 
-func compactTasks(cmd *cobra.Command, ctx *context.Context, archive bool) (int, error) {
+func compactTasks(
+		cmd *cobra.Command, ctx *context.Context, archive bool,
+) (int, error) {
 	var tasksFile *context.FileInfo
 	for i := range ctx.Files {
 		if ctx.Files[i].Name == "TASKS.md" {
@@ -147,7 +164,10 @@ func compactTasks(cmd *cobra.Command, ctx *context.Context, archive bool) (int,
 			matches := completedPattern.FindStringSubmatch(line)
 			if len(matches) > 1 {
 				completedTasks = append(completedTasks, matches[1])
-				cmd.Printf("%s Moving completed task: %s\n", green("✓"), truncateString(matches[1], 50))
+				cmd.Printf(
+					"%s Moving completed task: %s\n", green("✓"),
+					truncateString(matches[1], 50),
+				)
 				changes++
 				continue // Don't add to newLines
 			}
@@ -163,7 +183,8 @@ func compactTasks(cmd *cobra.Command, ctx *context.Context, archive bool) (int,
 			if strings.HasPrefix(line, "## Completed") {
 				// Find the next line that's either empty or another section
 				insertIdx := i + 1
-				for insertIdx < len(newLines) && newLines[insertIdx] != "" && !strings.HasPrefix(newLines[insertIdx], "## ") {
+				for insertIdx < len(newLines) && newLines[insertIdx] != "" &&
+						!strings.HasPrefix(newLines[insertIdx], "## ") {
 					insertIdx++
 				}
 

internal/cli/init.go

@@ -67,7 +67,13 @@ The following files are created:
   - DRIFT.md         — Staleness signals and update triggers
   - AGENT_PLAYBOOK.md — How AI agents should use this system
 
-Use --minimal to only create essential files (TASKS.md, DECISIONS.md, CONSTITUTION.md).`,
+Use --minimal to only create essential files (TASKS.md, DECISIONS.md, CONSTITUTION.md).
+
+Examples:
+  ctx init                     # Full initialization with all templates
+  ctx init --minimal           # Only essential files (TASKS, DECISIONS, CONSTITUTION)
+  ctx init --force             # Overwrite existing files without prompting
+  ctx init --merge             # Auto-merge ctx content into existing CLAUDE.md`,
 		RunE: runInit,
 	}