feat: simplify CLI output for coding agents and release v0.0.2

Author: observerw

README.md

@@ -10,11 +10,11 @@ Built on top of [lsp-client](https://github.com/lsp-client/python-sdk) and [LSAP
 
 ## Key Features
 
+- **🤖 Built for Agents**: The CLI output is optimized for Coding Agents. By avoiding fancy TUI/UI elements and rich terminal formatting, it significantly reduces token consumption while maintaining high readability for LLMs.
 - **🚀 Instant Analysis**: Quickly get definitions, references, hover info, and completions from the terminal.
 - **🏢 Managed Server Lifecycle**: A background manager automatically handles language server processes, reusing them across requests for maximum performance.
 - **🧩 LSAP Integration**: Leverages the Language Server Agent Protocol for structured, agent-friendly responses with built-in pagination and text-based location finding.
 - **⚡ Async-First**: Built with `anyio` and `asyncer` for high-performance concurrent operations.
-- **🎨 Rich Output**: Beautifully formatted terminal output using `rich`.
 
 ## Installation
 
@@ -218,9 +218,6 @@ idle_timeout = 600
 # Log level: TRACE, DEBUG, INFO, WARNING, ERROR, CRITICAL
 log_level = "INFO"
 
-# Show ASCII art banner on startup
-show_banner = true
-
 # Default maximum items for paginated results (search, reference, etc.)
 # Set to null for no limit, or a number like 20
 default_max_items = 20
@@ -240,7 +237,6 @@ All settings can be overridden via environment variables:
 export LSP_DEBUG=true
 export LSP_LOG_LEVEL=DEBUG
 export LSP_DEFAULT_MAX_ITEMS=50
-export LSP_SHOW_BANNER=false
 ```
 
 ## Contributing

main.py

@@ -1,6 +1,6 @@
 [project]
 name = "lsp-cli"
-version = "0.0.1"
+version = "0.0.2"
 description = "Add your description here"
 readme = "README.md"
 requires-python = ">=3.13"

pyproject.toml

@@ -2,7 +2,6 @@
 from collections.abc import AsyncGenerator
 from contextlib import asynccontextmanager
 from pathlib import Path
-from textwrap import dedent
 from typing import Annotated, Literal
 
 import typer
@@ -37,7 +36,8 @@
 
 app = typer.Typer(
     help="LSP CLI: A command-line tool for interacting with Language Server Protocol (LSP) features.",
-    add_completion=True,
+    add_completion=False,
+    rich_markup_mode=None,
     context_settings={"help_option_names": ["-h", "--help"]},
     pretty_exceptions_enable=False,
     pretty_exceptions_show_locals=False,
@@ -121,24 +121,7 @@ def main(
     ctx.ensure_object(dict)
     ctx.obj["markdown"] = markdown
     if ctx.invoked_subcommand is None:
-        if settings.show_banner:
-            console.print(
-                dedent(
-                    r"""
-                [bold cyan]
-                 _       ____    ____       ____   _       ___
-                | |     / ___|  |  _ \     / ___| | |     |_ _|
-                | |     \___ \  | |_) |   | |     | |      | |
-                | |___   ___) | |  __/    | |___  | |___   | |
-                |_____| |____/  |_|        \____| |_____| |___|
-                [/bold cyan]
-                """
-                )
-            )
-        console.print(
-            "\n[dim]LSP CLI tool - Type [bold]--help[/bold] for more info[/dim]\n"
-        )
-        console.print(ctx.get_help())
+        print(ctx.get_help())
         raise typer.Exit()
 
 

src/lsp_cli/__main__.py

@@ -4,8 +4,6 @@
 
 from lsp_client.jsonrpc.types import RawNotification, RawRequest, RawResponsePackage
 from pydantic import BaseModel
-from rich import box
-from rich.table import Table
 
 
 class ManagedClientInfo(BaseModel):
@@ -14,21 +12,14 @@ class ManagedClientInfo(BaseModel):
     remaining_time: float
 
     @classmethod
-    def format(cls, data: list[ManagedClientInfo] | ManagedClientInfo) -> Table:
-        table = Table(box=box.ROUNDED)
-        table.add_column("Language", style="cyan")
-        table.add_column("Project Path", style="green")
-        table.add_column("Remaining Time", style="magenta", justify="right")
-
+    def format(cls, data: list[ManagedClientInfo] | ManagedClientInfo) -> str:
         infos = [data] if isinstance(data, ManagedClientInfo) else data
-
+        lines = []
         for info in infos:
-            table.add_row(
-                info.language,
-                str(info.project_path),
-                f"{info.remaining_time:.1f}s",
+            lines.append(
+                f"{info.language:<10} {info.project_path} ({info.remaining_time:.1f}s)"
             )
-        return table
+        return "\n".join(lines)
 
 
 class CreateClientRequest(BaseModel):

src/lsp_cli/manager/models.py

@@ -25,7 +25,6 @@
         "--scope",
         "-s",
         help="Scope: 1-based line (e.g. '1'), line range (e.g. '1,10'), or symbol path (e.g. 'a.b.c')",
-        rich_help_panel="Scope",
     ),
 ]
 
@@ -35,7 +34,6 @@
         "--find",
         "-f",
         help="Text snippet to find",
-        rich_help_panel="Search",
     ),
 ]
 
@@ -44,7 +42,6 @@
     typer.Option(
         "--marker",
         help="Position marker in find pattern",
-        rich_help_panel="Search",
     ),
 ]
 
@@ -54,7 +51,6 @@
         "--max-items",
         "-n",
         help="Max items to return",
-        rich_help_panel="Pagination",
     ),
 ]
 
@@ -64,7 +60,6 @@
         "--start-index",
         "-i",
         help="Pagination offset",
-        rich_help_panel="Pagination",
     ),
 ]
 
@@ -74,7 +69,6 @@
         "--pagination-id",
         "-p",
         help="Pagination token",
-        rich_help_panel="Pagination",
     ),
 ]
 

src/lsp_cli/options.py

@@ -9,6 +9,8 @@
 app = typer.Typer(
     name="server",
     help="Manage background LSP server processes.",
+    add_completion=False,
+    rich_markup_mode=None,
     context_settings={"help_option_names": ["-h", "--help"]},
 )
 console = Console()

src/lsp_cli/server.py

@@ -24,7 +24,6 @@ class Settings(BaseSettings):
     log_level: LogLevel = "INFO"
 
     # UX improvements
-    show_banner: bool = True
     default_max_items: int | None = 20
     default_context_lines: int = 2
     ignore_paths: list[str] = [