deepagent-code 0.1.3__tar.gz → 0.1.5__tar.gz

{deepagent_code-0.1.3 → deepagent_code-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepagent-code
-Version: 0.1.3
+Version: 0.1.5
 Summary: A Claude Code-style CLI for running LangGraph agents from the terminal
 Author-email: Kedar Dabhadkar <kdabhadk@gmail.com>
 License-Expression: MIT
@@ -57,7 +57,7 @@ deepagent-code
 
 Or specify your own agent:
 ```bash
-deepagent-code path/to/your_agent.py:graph
+deepagent-code -a path/to/your_agent.py:graph
 ```
 
 This launches an interactive conversation loop with your agent.
@@ -68,14 +68,17 @@ This launches an interactive conversation loop with your agent.
 # Use the default agent
 deepagent-code
 
+# Send a message directly
+deepagent-code "Hello, agent!"
+
 # Specify a custom agent file
-deepagent-code my_agent.py:graph
+deepagent-code -a my_agent.py:graph
 
 # Use a module path
-deepagent-code mypackage.agents:chatbot
+deepagent-code -a mypackage.agents:chatbot
 
-# With an initial message
-deepagent-code -m "Hello, agent!"
+# Read message from a file
+deepagent-code -f ./prompt.md
 
 # Non-interactive mode (auto-approve tool calls)
 deepagent-code --no-interactive
@@ -95,7 +98,7 @@ In the interactive loop:
 
 ```bash
 # Agent location (path/to/file.py:variable_name or module:variable)
-export DEEPAGENT_AGENT_SPEC="my_agent.py:graph"
+export DEEPAGENT_SPEC="my_agent.py:graph"
 deepagent-code
 
 # Working directory
@@ -108,14 +111,15 @@ export DEEPAGENT_CONFIG='{"configurable": {"thread_id": "1"}}'
 ## CLI Options
 
 ```
-Usage: deepagent-code [OPTIONS] [AGENT_SPEC]
+Usage: deepagent-code [OPTIONS] [MESSAGE]
 
 Arguments:
-  AGENT_SPEC  Agent location (path/to/file.py:graph or module:graph)
+  MESSAGE  Optional input to send to the agent immediately
 
 Options:
+  -a, --agent TEXT                Agent spec (path/to/file.py:graph or module:graph)
   -g, --graph-name TEXT           Graph variable name (default: "graph")
-  -m, --message TEXT              Initial message
+  -f, --file PATH                 Read message from a file (any extension)
   -c, --config TEXT               Config JSON or file path
   --interactive/--no-interactive  Handle interrupts (default: interactive)
   --async-mode/--sync-mode        Async streaming (default: sync)
@@ -140,7 +144,7 @@ agent = create_deep_agent(
 
 Then run it:
 ```bash
-deepagent-code my_agent.py:agent
+deepagent-code -a my_agent.py:agent
 ```
 
 ## Programmatic Use

{deepagent_code-0.1.3 → deepagent_code-0.1.5}/README.md

@@ -25,7 +25,7 @@ deepagent-code
 
 Or specify your own agent:
 ```bash
-deepagent-code path/to/your_agent.py:graph
+deepagent-code -a path/to/your_agent.py:graph
 ```
 
 This launches an interactive conversation loop with your agent.
@@ -36,14 +36,17 @@ This launches an interactive conversation loop with your agent.
 # Use the default agent
 deepagent-code
 
+# Send a message directly
+deepagent-code "Hello, agent!"
+
 # Specify a custom agent file
-deepagent-code my_agent.py:graph
+deepagent-code -a my_agent.py:graph
 
 # Use a module path
-deepagent-code mypackage.agents:chatbot
+deepagent-code -a mypackage.agents:chatbot
 
-# With an initial message
-deepagent-code -m "Hello, agent!"
+# Read message from a file
+deepagent-code -f ./prompt.md
 
 # Non-interactive mode (auto-approve tool calls)
 deepagent-code --no-interactive
@@ -63,7 +66,7 @@ In the interactive loop:
 
 ```bash
 # Agent location (path/to/file.py:variable_name or module:variable)
-export DEEPAGENT_AGENT_SPEC="my_agent.py:graph"
+export DEEPAGENT_SPEC="my_agent.py:graph"
 deepagent-code
 
 # Working directory
@@ -76,14 +79,15 @@ export DEEPAGENT_CONFIG='{"configurable": {"thread_id": "1"}}'
 ## CLI Options
 
 ```
-Usage: deepagent-code [OPTIONS] [AGENT_SPEC]
+Usage: deepagent-code [OPTIONS] [MESSAGE]
 
 Arguments:
-  AGENT_SPEC  Agent location (path/to/file.py:graph or module:graph)
+  MESSAGE  Optional input to send to the agent immediately
 
 Options:
+  -a, --agent TEXT                Agent spec (path/to/file.py:graph or module:graph)
   -g, --graph-name TEXT           Graph variable name (default: "graph")
-  -m, --message TEXT              Initial message
+  -f, --file PATH                 Read message from a file (any extension)
   -c, --config TEXT               Config JSON or file path
   --interactive/--no-interactive  Handle interrupts (default: interactive)
   --async-mode/--sync-mode        Async streaming (default: sync)
@@ -108,7 +112,7 @@ agent = create_deep_agent(
 
 Then run it:
 ```bash
-deepagent-code my_agent.py:agent
+deepagent-code -a my_agent.py:agent
 ```
 
 ## Programmatic Use

{deepagent_code-0.1.3 → deepagent_code-0.1.5}/deepagent_code/cli.py

@@ -7,6 +7,7 @@ import importlib.util
 import json
 import os
 import re
+import subprocess
 import sys
 import threading
 import time
@@ -53,7 +54,7 @@ SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇",
 
 
 # Version info
-__version__ = "0.1.3"
+__version__ = "0.1.5"
 
 
 # Slash command registry
@@ -256,8 +257,87 @@ def get_agent_name(graph) -> str:
     return "AgentCode"
 
 
-def print_header_box(agent_name: str, cwd: str):
-    """Print an elegant header with the agent name and version."""
+def get_agent_description(graph) -> Optional[str]:
+    """Extract agent description from graph object, if available."""
+    # Try common attribute names for agent description
+    for attr in ('description', 'agent_description', '_description', '__doc__'):
+        if hasattr(graph, attr):
+            desc = getattr(graph, attr)
+            if desc and isinstance(desc, str) and desc.strip():
+                return desc.strip()
+    # Check if it's a compiled graph with a description in builder
+    if hasattr(graph, 'builder') and hasattr(graph.builder, 'description'):
+        desc = graph.builder.description
+        if desc and isinstance(desc, str) and desc.strip():
+            return desc.strip()
+    return None
+
+
+def text_to_ascii_art(text: str) -> List[str]:
+    """Convert text to ASCII art using a clean block font.
+
+    Returns a list of strings, one per line of the ASCII art.
+    All characters are exactly 3 chars wide for consistent spacing.
+    """
+    # Clean 3-line block font - each char is exactly 3 wide
+    FONT = {
+        'A': ['▄▀▄', '█▀█', '▀ ▀'],
+        'B': ['█▀▄', '█▀▄', '▀▀▀'],
+        'C': ['▄▀▀', '█  ', '▀▀▀'],
+        'D': ['█▀▄', '█ █', '▀▀▀'],
+        'E': ['█▀▀', '█▀▀', '▀▀▀'],
+        'F': ['█▀▀', '█▀▀', '▀  '],
+        'G': ['▄▀▀', '█▀█', '▀▀▀'],
+        'H': ['█ █', '█▀█', '▀ ▀'],
+        'I': ['▀█▀', ' █ ', '▀▀▀'],
+        'J': ['▀▀█', '  █', '▀▀▀'],
+        'K': ['█ █', '█▀▄', '▀ ▀'],
+        'L': ['█  ', '█  ', '▀▀▀'],
+        'M': ['█▄█', '█ █', '▀ ▀'],
+        'N': ['█▀█', '█ █', '▀ ▀'],
+        'O': ['▄▀▄', '█ █', '▀▀▀'],
+        'P': ['█▀▄', '█▀▀', '▀  '],
+        'Q': ['▄▀▄', '█ █', '▀▀█'],
+        'R': ['█▀▄', '█▀▄', '▀ ▀'],
+        'S': ['▄▀▀', '▀▀▄', '▀▀▀'],
+        'T': ['▀█▀', ' █ ', ' ▀ '],
+        'U': ['█ █', '█ █', '▀▀▀'],
+        'V': ['█ █', '█ █', ' ▀ '],
+        'W': ['█ █', '█▀█', '▀ ▀'],
+        'X': ['▀▄▀', ' █ ', '▀ ▀'],
+        'Y': ['█ █', ' █ ', ' ▀ '],
+        'Z': ['▀▀█', ' █ ', '█▀▀'],
+        '0': ['▄▀▄', '█ █', '▀▀▀'],
+        '1': ['▄█ ', ' █ ', '▀▀▀'],
+        '2': ['▀▀█', '▄▀▀', '▀▀▀'],
+        '3': ['▀▀█', ' ▀█', '▀▀▀'],
+        '4': ['█ █', '▀▀█', '  ▀'],
+        '5': ['█▀▀', '▀▀▄', '▀▀▀'],
+        '6': ['▄▀▀', '█▀█', '▀▀▀'],
+        '7': ['▀▀█', '  █', '  ▀'],
+        '8': ['▄▀▄', '█▀█', '▀▀▀'],
+        '9': ['▄▀█', '▀▀█', '▀▀▀'],
+        ' ': ['   ', '   ', '   '],
+        '-': ['   ', '▀▀▀', '   '],
+        '_': ['   ', '   ', '▀▀▀'],
+        '.': ['   ', '   ', ' ▀ '],
+    }
+
+    # Default char for unknown characters
+    DEFAULT = ['   ', ' █ ', '   ']
+
+    lines = ['', '', '']
+    for char in text.upper():
+        char_art = FONT.get(char, DEFAULT)
+        for i in range(3):
+            lines[i] += char_art[i] + ' '
+
+    # Remove only the final trailing space we added (not internal spaces from chars like T, P)
+    return [line[:-1] if line.endswith(' ') else line for line in lines]
+
+
+def print_header_box(agent_name: str, cwd: str, description: Optional[str] = None):
+    """Print an elegant header with ASCII art agent name, optional description, and cwd."""
     term_width = get_terminal_width()
 
     # Box drawing characters
@@ -267,15 +347,41 @@ def print_header_box(agent_name: str, cwd: str):
     # Calculate inner width (accounting for borders and padding)
     inner_width = term_width - 4  # 2 for borders, 2 for padding
 
-    # Build the header content
-    title_line = agent_name.center(inner_width)
-    cwd_display = cwd if len(cwd) <= inner_width else "..." + cwd[-(inner_width - 3):]
-    cwd_line = cwd_display.center(inner_width)
+    # Generate ASCII art for agent name
+    ascii_lines = text_to_ascii_art(agent_name)
+    ascii_width = max(len(line) for line in ascii_lines) if ascii_lines else 0
+
+    # Use ASCII art if it fits in terminal width
+    use_ascii = ascii_width <= inner_width
+
+    # Build cwd line with label
+    cwd_label = "cwd: "
+    max_cwd_len = inner_width - len(cwd_label)
+    cwd_display = cwd if len(cwd) <= max_cwd_len else "..." + cwd[-(max_cwd_len - 3):]
+    cwd_with_label = f"{cwd_label}{cwd_display}"
+    cwd_line = cwd_with_label.center(inner_width)
 
     # Print the box with gradient-style coloring
     print()
     print(f"{BRIGHT_CYAN}{TL}{H * (term_width - 2)}{TR}{RESET}")
-    print(f"{BRIGHT_CYAN}{V}{RESET} {BOLD}{BRIGHT_CYAN}{title_line}{RESET} {BRIGHT_CYAN}{V}{RESET}")
+
+    if use_ascii:
+        # Print ASCII art lines centered
+        for line in ascii_lines:
+            centered_line = line.center(inner_width)
+            print(f"{BRIGHT_CYAN}{V}{RESET} {BOLD}{BRIGHT_CYAN}{centered_line}{RESET} {BRIGHT_CYAN}{V}{RESET}")
+    else:
+        # Fall back to plain text if ASCII art doesn't fit
+        title_line = agent_name.center(inner_width)
+        print(f"{BRIGHT_CYAN}{V}{RESET} {BOLD}{BRIGHT_CYAN}{title_line}{RESET} {BRIGHT_CYAN}{V}{RESET}")
+
+    # Print description line if available
+    if description:
+        # Truncate description if too long
+        desc_display = description if len(description) <= inner_width else description[:inner_width - 3] + "..."
+        desc_line = desc_display.center(inner_width)
+        print(f"{CYAN}{V}{RESET} {DIM}{ITALIC}{desc_line}{RESET} {CYAN}{V}{RESET}")
+
     print(f"{CYAN}{V}{RESET} {DIM}{cwd_line}{RESET} {CYAN}{V}{RESET}")
     print(f"{CYAN}{BL}{H * (term_width - 2)}{BR}{RESET}")
 
@@ -298,7 +404,7 @@ def render_markdown(text: str) -> str:
 
 def parse_agent_spec(agent_spec: str) -> Tuple[str, str]:
     """
-    Parse DEEPAGENT_AGENT_SPEC format: path/to/file.py:variable_name.
+    Parse agent spec format: path/to/file.py:variable_name.
 
     Args:
         agent_spec: Agent specification string
@@ -1090,21 +1196,25 @@ def run_conversation_loop(
     graph,
     config: Dict[str, Any],
     agent_name: str = "AgentCode",
+    agent_description: Optional[str] = None,
     use_async: bool = False,
     interactive: bool = True,
     verbose: bool = False,
     stream_mode: str = "updates",
     initial_message: Optional[str] = None,
+    single_shot: bool = False,
 ):
     """
     Run a continuous conversation loop with the LangGraph agent.
     Styled after Claude Code / nanocode.
+
+    If single_shot is True and initial_message is provided, exit after processing.
     """
     # Set up tab completion for slash commands
     setup_readline_completion()
 
-    # Print box-drawn header with agent name
-    print_header_box(agent_name, os.getcwd())
+    # Print box-drawn header with agent name and description
+    print_header_box(agent_name, os.getcwd(), agent_description)
 
     # Print welcome message with tips
     print_welcome()
@@ -1135,6 +1245,10 @@ def run_conversation_loop(
         print_timing(duration, verbose)
         print()
 
+        # Exit after single-shot execution
+        if single_shot:
+            return
+
     # Main conversation loop
     while True:
         try:
@@ -1167,6 +1281,28 @@ def run_conversation_loop(
                         print(f"{DIM}Type /help to see available commands{RESET}")
                 continue
 
+            # Handle bang commands (!) - execute bash directly
+            if user_input.startswith("!"):
+                bash_cmd = user_input[1:].strip()
+                if bash_cmd:
+                    print()
+                    try:
+                        result = subprocess.run(
+                            bash_cmd,
+                            shell=True,
+                            capture_output=True,
+                            text=True,
+                        )
+                        if result.stdout:
+                            print(result.stdout, end="")
+                        if result.stderr:
+                            print(f"{RED}{result.stderr}{RESET}", end="")
+                        if result.returncode != 0:
+                            print(f"{DIM}Exit code: {result.returncode}{RESET}")
+                    except Exception as e:
+                        print(f"{RED}Error executing command: {e}{RESET}")
+                continue
+
             # Handle "exit" as a special case (without slash)
             if user_input.lower() == "exit":
                 break
@@ -1193,16 +1329,24 @@ def run_conversation_loop(
 
 
 @click.command()
-@click.argument("agent_spec", required=False)
+@click.argument("message", required=False)
+@click.option(
+    "--agent",
+    "-a",
+    "agent_spec",
+    help="Agent spec: path/to/file.py, path/to/file.py:graph, or module.path:graph",
+)
 @click.option(
     "--graph-name",
     "-g",
     help="Name of the graph variable (default: 'graph', overridden if spec includes :name)",
 )
 @click.option(
-    "--message",
-    "-m",
-    help="Input message to send to the agent",
+    "--file",
+    "-f",
+    "prompt_file",
+    type=click.Path(exists=True),
+    help="Read input message from a file (any extension)",
 )
 @click.option(
     "--config",
@@ -1231,9 +1375,10 @@ def run_conversation_loop(
     help="Show verbose output including node names",
 )
 def main(
+    message: Optional[str],
     agent_spec: Optional[str],
     graph_name: Optional[str],
-    message: Optional[str],
+    prompt_file: Optional[str],
     config: Optional[str],
     interactive: bool,
     use_async: bool,
@@ -1243,7 +1388,9 @@ def main(
     """
     Run a LangGraph agent from the command line.
 
-    AGENT_SPEC can be:
+    MESSAGE is an optional input to send to the agent immediately.
+
+    Agent spec (-a/--agent) can be:
     \b
     - path/to/file.py           (uses default graph name 'graph')
     - path/to/file.py:agent     (specifies graph variable name)
@@ -1253,7 +1400,7 @@ def main(
     Supports environment variables for configuration:
 
     \b
-    - DEEPAGENT_AGENT_SPEC: Agent location (same formats as above)
+    - DEEPAGENT_SPEC: Agent location (same formats as above)
     - DEEPAGENT_WORKSPACE_ROOT: Working directory for the agent
     - DEEPAGENT_CONFIG: Configuration JSON string or path to JSON file
     - DEEPAGENT_STREAM_MODE: Stream mode for LangGraph (updates or values)
@@ -1262,14 +1409,30 @@ def main(
 
     \b
     Examples:
-        deepagent-code my_agent.py
-        deepagent-code my_agent.py:graph
-        deepagent-code mypackage.agents:chatbot
-        deepagent-code -m "Hello, agent!"
+        deepagent-code "Hello, agent!"
+        deepagent-code -a my_agent.py "What can you do?"
+        deepagent-code -a my_agent.py:graph
+        deepagent-code -f ./prompt.md
     """
     try:
-        # Get environment variables
-        env_agent_spec = os.getenv('DEEPAGENT_AGENT_SPEC')
+        # Handle -f/--file option: read message from file
+        if prompt_file and message:
+            print(f"{RED}⏺ Error: Cannot use both MESSAGE argument and -f/--file option{RESET}")
+            sys.exit(1)
+
+        if prompt_file:
+            try:
+                with open(prompt_file, 'r', encoding='utf-8') as f:
+                    message = f.read().strip()
+                if not message:
+                    print(f"{RED}⏺ Error: File '{prompt_file}' is empty{RESET}")
+                    sys.exit(1)
+            except Exception as e:
+                print(f"{RED}⏺ Error reading file '{prompt_file}': {e}{RESET}")
+                sys.exit(1)
+
+        # Get environment variables (DEEPAGENT_SPEC preferred, DEEPAGENT_AGENT_SPEC for backwards compat)
+        env_agent_spec = os.getenv('DEEPAGENT_SPEC') or os.getenv('DEEPAGENT_AGENT_SPEC')
         env_workspace_root = os.getenv('DEEPAGENT_WORKSPACE_ROOT')
         env_config = os.getenv('DEEPAGENT_CONFIG')
         env_stream_mode = os.getenv('DEEPAGENT_STREAM_MODE', 'updates')
@@ -1288,7 +1451,7 @@ def main(
                 print(f"\n{DIM}Usage:{RESET}")
                 print(f"  deepagent-code path/to/agent.py:graph")
                 print(f"  deepagent-code mypackage.module:agent")
-                print(f"\n{DIM}Or set DEEPAGENT_AGENT_SPEC environment variable{RESET}")
+                print(f"\n{DIM}Or set DEEPAGENT_SPEC environment variable{RESET}")
                 sys.exit(1)
 
         # Change to workspace root if specified
@@ -1331,19 +1494,23 @@ def main(
         if "thread_id" not in config_dict["configurable"]:
             config_dict["configurable"]["thread_id"] = str(uuid.uuid4())
 
-        # Extract agent name from graph object
+        # Extract agent name and description from graph object
         agent_name = get_agent_name(graph)
+        agent_description = get_agent_description(graph)
 
         # Run the conversation loop
+        # Single-shot mode: exit after processing if message was provided via CLI
         run_conversation_loop(
             graph=graph,
             config=config_dict,
             agent_name=agent_name,
+            agent_description=agent_description,
             use_async=use_async,
             interactive=interactive,
             verbose=verbose,
             stream_mode=final_stream_mode,
             initial_message=message,
+            single_shot=bool(message),
         )
 
     except FileNotFoundError as e:

{deepagent_code-0.1.3 → deepagent_code-0.1.5}/deepagent_code.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepagent-code
-Version: 0.1.3
+Version: 0.1.5
 Summary: A Claude Code-style CLI for running LangGraph agents from the terminal
 Author-email: Kedar Dabhadkar <kdabhadk@gmail.com>
 License-Expression: MIT
@@ -57,7 +57,7 @@ deepagent-code
 
 Or specify your own agent:
 ```bash
-deepagent-code path/to/your_agent.py:graph
+deepagent-code -a path/to/your_agent.py:graph
 ```
 
 This launches an interactive conversation loop with your agent.
@@ -68,14 +68,17 @@ This launches an interactive conversation loop with your agent.
 # Use the default agent
 deepagent-code
 
+# Send a message directly
+deepagent-code "Hello, agent!"
+
 # Specify a custom agent file
-deepagent-code my_agent.py:graph
+deepagent-code -a my_agent.py:graph
 
 # Use a module path
-deepagent-code mypackage.agents:chatbot
+deepagent-code -a mypackage.agents:chatbot
 
-# With an initial message
-deepagent-code -m "Hello, agent!"
+# Read message from a file
+deepagent-code -f ./prompt.md
 
 # Non-interactive mode (auto-approve tool calls)
 deepagent-code --no-interactive
@@ -95,7 +98,7 @@ In the interactive loop:
 
 ```bash
 # Agent location (path/to/file.py:variable_name or module:variable)
-export DEEPAGENT_AGENT_SPEC="my_agent.py:graph"
+export DEEPAGENT_SPEC="my_agent.py:graph"
 deepagent-code
 
 # Working directory
@@ -108,14 +111,15 @@ export DEEPAGENT_CONFIG='{"configurable": {"thread_id": "1"}}'
 ## CLI Options
 
 ```
-Usage: deepagent-code [OPTIONS] [AGENT_SPEC]
+Usage: deepagent-code [OPTIONS] [MESSAGE]
 
 Arguments:
-  AGENT_SPEC  Agent location (path/to/file.py:graph or module:graph)
+  MESSAGE  Optional input to send to the agent immediately
 
 Options:
+  -a, --agent TEXT                Agent spec (path/to/file.py:graph or module:graph)
   -g, --graph-name TEXT           Graph variable name (default: "graph")
-  -m, --message TEXT              Initial message
+  -f, --file PATH                 Read message from a file (any extension)
   -c, --config TEXT               Config JSON or file path
   --interactive/--no-interactive  Handle interrupts (default: interactive)
   --async-mode/--sync-mode        Async streaming (default: sync)
@@ -140,7 +144,7 @@ agent = create_deep_agent(
 
 Then run it:
 ```bash
-deepagent-code my_agent.py:agent
+deepagent-code -a my_agent.py:agent
 ```
 
 ## Programmatic Use

{deepagent_code-0.1.3 → deepagent_code-0.1.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepagent-code"
-version = "0.1.3"
+version = "0.1.5"
 description = "A Claude Code-style CLI for running LangGraph agents from the terminal"
 readme = "README.md"
 requires-python = ">=3.11"