Better help

Author: jancurn

src/cli/index.ts

@@ -323,11 +323,8 @@ function createTopLevelProgram(): Command {
   program.addHelpText(
     'after',
     `
-Session commands (after connecting):
+MCP session commands (after connecting):
   <@session>                   Show MCP server info and capabilities
-  <@session> shell             Open interactive shell
-  <@session> close             Close the session
-  <@session> restart           Kill and restart the session
   <@session> tools-list        List MCP tools
   <@session> tools-get <name>
   <@session> tools-call <name> [arg:=val ... | <json> | <stdin]
@@ -405,7 +402,7 @@ Server formats:
 
   // close command: mcpc close @<session>
   program
-    .command('close [@session]', { hidden: true })
+    .command('close [@session]')
     .usage('<@session>')
     .description('Close a session')
     .action(async (sessionName, _opts, command) => {
@@ -417,9 +414,9 @@ Server formats:
 
   // restart command: mcpc restart @<session>
   program
-    .command('restart [@session]', { hidden: true })
+    .command('restart [@session]')
     .usage('<@session>')
-    .description('Restart a session')
+    .description('Restart a session (losing all state)')
     .action(async (sessionName, _opts, command) => {
       if (!sessionName) {
         throw new ClientError(
@@ -431,7 +428,7 @@ Server formats:
 
   // shell command: mcpc shell @<session>
   program
-    .command('shell [@session]', { hidden: true })
+    .command('shell [@session]')
     .usage('<@session>')
     .description('Open interactive shell for a session')
     .action(async (sessionName) => {
@@ -445,7 +442,7 @@ Server formats:
   program
     .command('login [server]')
     .usage('<server>')
-    .description('Authenticate to server using OAuth and save the profile')
+    .description('Open web browser for interactive login to a server using OAuth')
     .option('--profile <name>', 'Profile name (default: "default")')
     .option('--scope <scope>', 'OAuth scope(s) to request')
     .action(async (server, opts, command) => {
@@ -608,7 +605,7 @@ function registerSessionCommands(program: Command, session: string): void {
 
   // Close command
   program
-    .command('close')
+    .command('close', { hidden: true })
     .description('Close the session')
     .action(async (_options, command) => {
       await sessions.closeSession(session, getOptionsFromCommand(command));