From eb9baa1699f34ec5ab5908d41ee0213dbe6f3216 Mon Sep 17 00:00:00 2001
From: Aidan Daly <99039782+aidandaly24@users.noreply.github.com>
Date: Fri, 13 Mar 2026 16:56:00 -0400
Subject: [PATCH 1/2] fix: Add a --help examples section to the CLI (#6)

---
 src/cli/tui/copy.ts | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/src/cli/tui/copy.ts b/src/cli/tui/copy.ts
index 507365da3..6f3ea84d8 100644
--- a/src/cli/tui/copy.ts
+++ b/src/cli/tui/copy.ts
@@ -43,3 +43,12 @@ export const COMMAND_DESCRIPTIONS = {
   update: 'Check for and install CLI updates',
   validate: 'Validate agentcore/ config files.',
 } as const;
+
+/**
+ * Example commands shown in --help output.
+ */
+export const HELP_EXAMPLES = [
+  { command: 'agentcore create', description: 'Create a new project with guided setup' },
+  { command: 'agentcore dev', description: 'Start local development server' },
+  { command: 'agentcore deploy --target default', description: 'Deploy to AWS using default target' },
+] as const;

From 1561a50f687be40e206346b03c1a945e3d4ccc84 Mon Sep 17 00:00:00 2001
From: Aidan Daly <99039782+aidandaly24@users.noreply.github.com>
Date: Fri, 13 Mar 2026 16:56:12 -0400
Subject: [PATCH 2/2] fix: Add examples section to CommandListScreen (#6)

---
 src/cli/tui/screens/home/CommandListScreen.tsx | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/src/cli/tui/screens/home/CommandListScreen.tsx b/src/cli/tui/screens/home/CommandListScreen.tsx
index f2d2f1498..d38a173ac 100644
--- a/src/cli/tui/screens/home/CommandListScreen.tsx
+++ b/src/cli/tui/screens/home/CommandListScreen.tsx
@@ -1,4 +1,5 @@
 import { buildLogo, useLayout } from '../../context';
+import { HELP_EXAMPLES } from '../../copy';
 import type { CommandMeta } from '../../utils/commands';
 import { Box, Text, useApp } from 'ink';
 import React, { useEffect } from 'react';
@@ -56,6 +57,22 @@ export function CommandListScreen({ commands }: CommandListScreenProps) {
         );
       })}
       <Text> </Text>
+      <Text bold color="yellow">
+        Examples:
+      </Text>
+      {HELP_EXAMPLES.map(example => (
+        <Box key={example.command} flexDirection="column">
+          <Box>
+            <Text> $ </Text>
+            <Text color="green">{example.command}</Text>
+          </Box>
+          <Box>
+            <Text>   </Text>
+            <Text dimColor>{example.description}</Text>
+          </Box>
+        </Box>
+      ))}
+      <Text> </Text>
       <Text dimColor>Run agentcore [command] --help for command-specific help</Text>
       <Text dimColor>Run agentcore (no args) for interactive mode</Text>
     </Box>