Add command descriptions

src/chap/commands/ask.py

@@ -89,6 +89,7 @@ async def work():
 def main(
     continue_session, last, new_session, system_message, prompt, backend
 ):  # pylint: disable=too-many-arguments
+    """Ask a question (command-line argument is passed as prompt)"""
     if bool(continue_session) + bool(last) + bool(new_session) > 1:
         raise SystemExit(
             "--continue-session, --last and --new_session are mutually exclusive"

src/chap/commands/cat.py

@@ -12,6 +12,7 @@
 @click.option("--session", "-s", type=click.Path(exists=True), default=None)
 @click.option("--last", is_flag=True)
 def main(session, last):
+    """Print session in plaintext"""
     if bool(session) + bool(last) != 1:
         raise SystemExit("Specify either --session, or --last")
 

src/chap/commands/grep.py

@@ -34,6 +34,7 @@ def list_files_matching_rx(
 @click.option("--fixed-strings", "--literal", "-F", is_flag=True)
 @click.argument("pattern", nargs=1, required=True)
 def main(ignore_case, fixed_strings, pattern):
+    """Search sessions for pattern"""
     console = rich.get_console()
     if fixed_strings:
         pattern = re.escape(pattern)

src/chap/commands/render.py

@@ -30,6 +30,7 @@ def to_markdown(message):
 @click.option("--session", "-s", type=click.Path(exists=True), default=None)
 @click.option("--last", is_flag=True)
 def main(session, last):
+    """Print session with formatting"""
     if bool(session) + bool(last) != 1:
         raise SystemExit("Specify either --session, or --last")
 

src/chap/commands/tui.py

@@ -121,6 +121,7 @@ def action_yank(self):
 @click.option("--system-message", "-S", type=str, default=None)
 @click.option("--backend", "-b", type=str, default="openai_chatgpt")
 def main(continue_session, last, new_session, system_message, backend):
+    """Start interactive terminal user interface session"""
     if bool(continue_session) + bool(last) + bool(new_session) > 1:
         raise SystemExit(
             "--continue-session, --last and --new_session are mutually exclusive"