sentarc-coding-agent 0.1.0__tar.gz

sentarc_coding_agent-0.1.0/PKG-INFO

@@ -0,0 +1,16 @@
+Metadata-Version: 2.4
+Name: sentarc-coding-agent
+Version: 0.1.0
+Summary: Sentarc coding agent CLI (arc command)
+Requires-Python: >=3.11
+Requires-Dist: sentarc-ai
+Requires-Dist: sentarc-agent
+Requires-Dist: pathspec>=0.12.0
+Requires-Dist: python-frontmatter>=1.0.0
+Requires-Dist: Pillow>=10.0.0
+Requires-Dist: pyperclip>=1.9.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: filetype>=1.2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"

sentarc_coding_agent-0.1.0/README.md

@@ -0,0 +1,39 @@
+# sentarc-coding-agent
+
+Sentarc coding agent CLI — the `arc` command.
+
+## Usage
+
+```bash
+arc [options] [@files...] [messages...]
+```
+
+## Options
+
+- `--provider <name>` — Provider name (default: google)
+- `--model <pattern>` — Model pattern or ID
+- `--api-key <key>` — API key
+- `--system-prompt <text>` — Custom system prompt
+- `--append-system-prompt <text>` — Append to system prompt
+- `--mode <mode>` — Output mode: text (default), json, rpc
+- `--print, -p` — Non-interactive mode
+- `--continue, -c` — Continue previous session
+- `--resume, -r` — Select a session to resume
+- `--session <path>` — Use specific session file
+- `--no-session` — Don't save session
+- `--tools <tools>` — Comma-separated tool names (read,bash,edit,write,grep,find,ls)
+- `--no-tools` — Disable all tools
+- `--thinking <level>` — Thinking level: off, minimal, low, medium, high, xhigh
+- `--list-models [search]` — List available models
+- `--help, -h` — Show help
+- `--version, -v` — Show version
+
+## Available Tools (default: read, bash, edit, write)
+
+- `read` — Read file contents
+- `bash` — Execute bash commands
+- `edit` — Edit files with find/replace
+- `write` — Write files (creates/overwrites)
+- `grep` — Search file contents (read-only)
+- `find` — Find files by glob pattern (read-only)
+- `ls` — List directory contents (read-only)

sentarc_coding_agent-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[project]
+name = "sentarc-coding-agent"
+version = "0.1.0"
+description = "Sentarc coding agent CLI (arc command)"
+requires-python = ">=3.11"
+dependencies = [
+    "sentarc-ai",
+    "sentarc-agent",
+    "pathspec>=0.12.0",
+    "python-frontmatter>=1.0.0",
+    "Pillow>=10.0.0",
+    "pyperclip>=1.9.0",
+    "pyyaml>=6.0.0",
+    "filetype>=1.2.0",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=7.0.0", "pytest-asyncio>=0.21.0"]
+
+[project.scripts]
+arc = "sentarc_coding_agent.cli:main"
+
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+package-dir = {"sentarc_coding_agent" = "src"}
+packages = [
+    "sentarc_coding_agent",
+    "sentarc_coding_agent.cli",
+    "sentarc_coding_agent.core",
+    "sentarc_coding_agent.core.tools",
+    "sentarc_coding_agent.core.compaction",
+    "sentarc_coding_agent.core.extensions",
+    "sentarc_coding_agent.modes",
+    "sentarc_coding_agent.modes.interactive",
+    "sentarc_coding_agent.modes.interactive.components",
+    "sentarc_coding_agent.modes.rpc",
+    "sentarc_coding_agent.utils",
+]

sentarc_coding_agent-0.1.0/sentarc_coding_agent.egg-info/PKG-INFO

@@ -0,0 +1,16 @@
+Metadata-Version: 2.4
+Name: sentarc-coding-agent
+Version: 0.1.0
+Summary: Sentarc coding agent CLI (arc command)
+Requires-Python: >=3.11
+Requires-Dist: sentarc-ai
+Requires-Dist: sentarc-agent
+Requires-Dist: pathspec>=0.12.0
+Requires-Dist: python-frontmatter>=1.0.0
+Requires-Dist: Pillow>=10.0.0
+Requires-Dist: pyperclip>=1.9.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: filetype>=1.2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"

sentarc_coding_agent-0.1.0/sentarc_coding_agent.egg-info/SOURCES.txt

@@ -0,0 +1,69 @@
+README.md
+pyproject.toml
+sentarc_coding_agent.egg-info/PKG-INFO
+sentarc_coding_agent.egg-info/SOURCES.txt
+sentarc_coding_agent.egg-info/dependency_links.txt
+sentarc_coding_agent.egg-info/entry_points.txt
+sentarc_coding_agent.egg-info/requires.txt
+sentarc_coding_agent.egg-info/top_level.txt
+src/__init__.py
+src/cli.py
+src/config.py
+src/cli/__init__.py
+src/cli/args.py
+src/cli/config_selector.py
+src/cli/file_processor.py
+src/cli/list_models.py
+src/cli/session_picker.py
+src/core/__init__.py
+src/core/agent_session.py
+src/core/auth_storage.py
+src/core/bash_executor.py
+src/core/messages.py
+src/core/model_registry.py
+src/core/model_resolver.py
+src/core/prompt_templates.py
+src/core/session_manager.py
+src/core/settings_manager.py
+src/core/skills.py
+src/core/slash_commands.py
+src/core/system_prompt.py
+src/core/compaction/__init__.py
+src/core/compaction/compaction.py
+src/core/compaction/utils.py
+src/core/extensions/__init__.py
+src/core/extensions/loader.py
+src/core/extensions/runner.py
+src/core/extensions/types.py
+src/core/tools/__init__.py
+src/core/tools/bash.py
+src/core/tools/edit.py
+src/core/tools/edit_diff.py
+src/core/tools/find.py
+src/core/tools/grep.py
+src/core/tools/ls.py
+src/core/tools/path_utils.py
+src/core/tools/read.py
+src/core/tools/truncate.py
+src/core/tools/write.py
+src/modes/__init__.py
+src/modes/print_mode.py
+src/modes/interactive/__init__.py
+src/modes/interactive/interactive_mode.py
+src/modes/interactive/theme.py
+src/modes/interactive/components/__init__.py
+src/modes/interactive/components/assistant_message.py
+src/modes/interactive/components/footer.py
+src/modes/interactive/components/tool_execution.py
+src/modes/interactive/components/user_message.py
+src/modes/rpc/__init__.py
+src/modes/rpc/jsonl.py
+src/modes/rpc/rpc_mode.py
+src/modes/rpc/rpc_types.py
+src/utils/__init__.py
+src/utils/frontmatter.py
+src/utils/git.py
+src/utils/shell.py
+tests/test_path_utils.py
+tests/test_system_prompt.py
+tests/test_truncate.py

sentarc_coding_agent-0.1.0/sentarc_coding_agent.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

sentarc_coding_agent-0.1.0/sentarc_coding_agent.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+arc = sentarc_coding_agent.cli:main

sentarc_coding_agent-0.1.0/sentarc_coding_agent.egg-info/requires.txt

@@ -0,0 +1,12 @@
+sentarc-ai
+sentarc-agent
+pathspec>=0.12.0
+python-frontmatter>=1.0.0
+Pillow>=10.0.0
+pyperclip>=1.9.0
+pyyaml>=6.0.0
+filetype>=1.2.0
+
+[dev]
+pytest>=7.0.0
+pytest-asyncio>=0.21.0

sentarc_coding_agent-0.1.0/sentarc_coding_agent.egg-info/top_level.txt

@@ -0,0 +1 @@
+sentarc_coding_agent

sentarc_coding_agent-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

sentarc_coding_agent-0.1.0/src/__init__.py

@@ -0,0 +1,33 @@
+"""sentarc-coding-agent — Interactive coding agent CLI."""
+
+__version__ = "0.1.0"
+
+from sentarc_coding_agent.config import (
+    APP_NAME,
+    CONFIG_DIR_NAME,
+    VERSION,
+    get_agent_dir,
+    get_sessions_dir,
+    get_models_path,
+    get_auth_path,
+    get_settings_path,
+)
+from sentarc_coding_agent.core.tools import (
+    create_all_tools,
+    create_coding_tools,
+    create_read_only_tools,
+)
+
+__all__ = [
+    "APP_NAME",
+    "CONFIG_DIR_NAME",
+    "VERSION",
+    "get_agent_dir",
+    "get_sessions_dir",
+    "get_models_path",
+    "get_auth_path",
+    "get_settings_path",
+    "create_all_tools",
+    "create_coding_tools",
+    "create_read_only_tools",
+]

sentarc_coding_agent-0.1.0/src/cli/__init__.py

@@ -0,0 +1,218 @@
+"""CLI entry point for sentarc-coding-agent."""
+
+from __future__ import annotations
+
+import asyncio
+import os
+import sys
+from typing import List, Optional
+
+
+def main(argv: Optional[List[str]] = None) -> None:
+    """Main entry point — parse args and dispatch to appropriate mode."""
+    if argv is None:
+        argv = sys.argv[1:]
+    try:
+        asyncio.run(_main_async(argv))
+    except KeyboardInterrupt:
+        sys.exit(0)
+
+
+async def _main_async(argv: List[str]) -> None:
+    from sentarc_coding_agent.cli.args import parse_args, print_help
+    from sentarc_coding_agent.config import VERSION, APP_NAME, get_agent_dir, get_custom_themes_dir
+    from sentarc_coding_agent.core.tools import create_tools, TOOL_NAMES
+    from sentarc_coding_agent.core.system_prompt import build_system_prompt
+    from sentarc_coding_agent.core.model_resolver import resolve_model
+    from sentarc_coding_agent.core.settings_manager import load_settings
+    from sentarc_coding_agent.core.skills import load_skills
+    from sentarc_coding_agent.core.extensions.loader import discover_extensions
+    from sentarc_coding_agent.core.messages import convert_to_llm
+
+    args = parse_args(argv)
+
+    # --- Simple flag handling ---
+    if args.get("help"):
+        print_help()
+        return
+
+    if args.get("version"):
+        print(f"{APP_NAME} {VERSION}")
+        return
+
+    if args.get("list_models") is not None:
+        from sentarc_coding_agent.cli.list_models import list_models
+        search = args["list_models"] if isinstance(args["list_models"], str) else None
+        list_models(search)
+        return
+
+    # --- Load settings ---
+    settings = load_settings()
+
+    # --- Resolve model ---
+    provider = args.get("provider") or settings.provider or "google"
+    model_spec = args.get("model") or settings.model or "gemini-2.5-flash"
+    resolved_provider, model_id, model_thinking = resolve_model(provider, model_spec)
+    thinking_level = args.get("thinking") or model_thinking or settings.thinking or "off"
+
+    try:
+        from sentarc_ai.models import get_model
+        model_def = get_model(resolved_provider, model_id)
+    except Exception as e:
+        print(f"Error: Could not resolve model {resolved_provider}/{model_id}: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    # --- Build tools ---
+    cwd = os.getcwd()
+    no_tools = args.get("no_tools", False)
+    if no_tools:
+        tool_names: List[str] = []
+    elif args.get("tools"):
+        tool_names = args["tools"]
+    else:
+        tool_names = list(settings.tools or ["read", "bash", "edit", "write"])
+
+    tools = create_tools(cwd, tool_names) if tool_names else []
+
+    # --- Load skills ---
+    skills: list = []
+    if not args.get("no_skills"):
+        try:
+            skill_paths = args.get("skills") or []
+            loaded_skills, _ = load_skills(cwd=cwd, skill_paths=skill_paths)
+            skills = loaded_skills
+        except Exception:
+            pass
+
+    # --- Load context files ---
+    context_files: list = []
+    if args.get("file_args"):
+        try:
+            from sentarc_coding_agent.cli.file_processor import load_file_args
+            context_files = [
+                f for f in load_file_args(args["file_args"], cwd)
+                if f.get("type") == "text"
+            ]
+        except Exception as e:
+            print(f"Warning: Could not load context files: {e}", file=sys.stderr)
+
+    # --- Build system prompt ---
+    custom_prompt = args.get("system_prompt")
+    append_prompt = args.get("append_system_prompt")
+    system_prompt = build_system_prompt(
+        custom_prompt=custom_prompt,
+        selected_tools=None if no_tools else tool_names,
+        append_system_prompt=append_prompt,
+        cwd=cwd,
+        context_files=context_files if context_files else None,
+        skills=skills if skills else None,
+    )
+
+    # --- Load extensions ---
+    all_agent_tools = list(tools)
+    if not args.get("no_extensions"):
+        try:
+            agent_dir = get_agent_dir()
+            extension_paths = args.get("extensions") or []
+            extensions = discover_extensions(
+                extension_paths=extension_paths,
+                agent_dir=agent_dir,
+            )
+            for ext in extensions:
+                custom = getattr(ext, "custom_tools", None)
+                if custom:
+                    all_agent_tools.extend(custom)
+        except Exception:
+            pass
+
+    # --- Create agent ---
+    try:
+        from sentarc_agent.agent import Agent
+        from sentarc_agent.types import AgentOptions
+    except ImportError as e:
+        print(f"Error: sentarc-agent not available: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    agent = Agent(AgentOptions(
+        convert_to_llm=convert_to_llm,
+        initial_state={
+            "system_prompt": system_prompt,
+            "model": model_def,
+            "thinking_level": thinking_level,
+            "tools": all_agent_tools,
+        },
+    ))
+
+    # --- Set up session ---
+    from sentarc_coding_agent.core.session_manager import SessionManager
+
+    session: Optional[SessionManager] = None
+    no_session = args.get("no_session", False)
+    if not no_session:
+        session_file = args.get("session")
+        if args.get("resume"):
+            from sentarc_coding_agent.cli.session_picker import select_session_interactive
+            session_id = select_session_interactive()
+            if session_id:
+                try:
+                    session = SessionManager.open(session_id)
+                except Exception:
+                    session = SessionManager.create(cwd)
+            else:
+                session = SessionManager.create(cwd)
+        elif args.get("continue"):
+            session = SessionManager.continue_recent(cwd)
+        elif session_file:
+            session = SessionManager.open(session_file)
+        else:
+            session = SessionManager.create(cwd)
+
+    # Load session history into agent state
+    if session:
+        context = session.build_session_context()
+        history = context.get("messages", [])
+        if history:
+            agent._state.messages = history
+        session_thinking = context.get("thinkingLevel")
+        if session_thinking and not args.get("thinking"):
+            agent._state.thinking_level = session_thinking
+
+    # --- Determine mode and run ---
+    mode = args.get("mode")
+    messages: List[str] = args.get("messages", [])
+    has_messages = bool(messages)
+    is_print = args.get("print", False) or has_messages
+
+    if mode == "rpc":
+        from sentarc_coding_agent.modes.rpc.rpc_mode import run_rpc_mode
+        await run_rpc_mode(agent)
+
+    elif is_print or mode == "json":
+        from sentarc_coding_agent.modes.print_mode import PrintModeOptions, run_print_mode
+        initial_msg = messages[0] if messages else None
+        extra_msgs = messages[1:] if len(messages) > 1 else []
+        opts = PrintModeOptions(
+            mode=mode if mode in ("text", "json") else "text",
+            initial_message=initial_msg,
+            messages=extra_msgs,
+        )
+        await run_print_mode(agent, opts)
+
+    else:
+        # Interactive TUI mode
+        try:
+            from sentarc_coding_agent.modes.interactive.interactive_mode import run_interactive_mode
+            from sentarc_coding_agent.modes.interactive.theme import load_theme
+            from pathlib import Path
+
+            themes_dir = Path(get_custom_themes_dir())
+            theme = load_theme("dark", themes_dir)
+            await run_interactive_mode(agent, theme=theme)
+        except ImportError:
+            # Fallback: basic stdin loop
+            from sentarc_coding_agent.core.agent_session import run_agent_session
+            await run_agent_session(args)
+
+
+if __name__ == "__main__":
+    main()

sentarc_coding_agent-0.1.0/src/cli/args.py

@@ -0,0 +1,218 @@
+"""
+CLI argument parsing and help display.
+"""
+
+from __future__ import annotations
+
+import sys
+from typing import Any, Dict, List, Optional
+
+from sentarc_coding_agent.config import APP_NAME, CONFIG_DIR_NAME, ENV_AGENT_DIR
+
+VALID_THINKING_LEVELS = ("off", "minimal", "low", "medium", "high", "xhigh")
+VALID_MODES = ("text", "json", "rpc")
+VALID_TOOLS = ("read", "bash", "edit", "write", "grep", "find", "ls")
+
+
+def is_valid_thinking_level(level: str) -> bool:
+    return level in VALID_THINKING_LEVELS
+
+
+def parse_args(
+    argv: List[str],
+    extension_flags: Optional[Dict[str, str]] = None,
+) -> Dict[str, Any]:
+    """
+    Parse CLI arguments, mirroring the TypeScript parseArgs() function.
+    Returns a dict with the same keys as the TS Args interface (snake_case).
+    """
+    result: Dict[str, Any] = {
+        "messages": [],
+        "file_args": [],
+        "unknown_flags": {},
+    }
+
+    i = 0
+    while i < len(argv):
+        arg = argv[i]
+
+        if arg in ("--help", "-h"):
+            result["help"] = True
+        elif arg in ("--version", "-v"):
+            result["version"] = True
+        elif arg == "--mode" and i + 1 < len(argv):
+            i += 1
+            mode = argv[i]
+            if mode in VALID_MODES:
+                result["mode"] = mode
+        elif arg in ("--continue", "-c"):
+            result["continue"] = True
+        elif arg in ("--resume", "-r"):
+            result["resume"] = True
+        elif arg == "--provider" and i + 1 < len(argv):
+            i += 1
+            result["provider"] = argv[i]
+        elif arg == "--model" and i + 1 < len(argv):
+            i += 1
+            result["model"] = argv[i]
+        elif arg == "--api-key" and i + 1 < len(argv):
+            i += 1
+            result["api_key"] = argv[i]
+        elif arg == "--system-prompt" and i + 1 < len(argv):
+            i += 1
+            result["system_prompt"] = argv[i]
+        elif arg == "--append-system-prompt" and i + 1 < len(argv):
+            i += 1
+            result["append_system_prompt"] = argv[i]
+        elif arg == "--no-session":
+            result["no_session"] = True
+        elif arg == "--session" and i + 1 < len(argv):
+            i += 1
+            result["session"] = argv[i]
+        elif arg == "--session-dir" and i + 1 < len(argv):
+            i += 1
+            result["session_dir"] = argv[i]
+        elif arg == "--models" and i + 1 < len(argv):
+            i += 1
+            result["models"] = [s.strip() for s in argv[i].split(",")]
+        elif arg == "--no-tools":
+            result["no_tools"] = True
+        elif arg == "--tools" and i + 1 < len(argv):
+            i += 1
+            tool_names = [s.strip() for s in argv[i].split(",")]
+            valid: List[str] = []
+            for name in tool_names:
+                if name in VALID_TOOLS:
+                    valid.append(name)
+                else:
+                    print(
+                        f"Warning: Unknown tool \"{name}\". Valid tools: {', '.join(VALID_TOOLS)}",
+                        file=sys.stderr,
+                    )
+            result["tools"] = valid
+        elif arg == "--thinking" and i + 1 < len(argv):
+            i += 1
+            level = argv[i]
+            if is_valid_thinking_level(level):
+                result["thinking"] = level
+            else:
+                print(
+                    f"Warning: Invalid thinking level \"{level}\". Valid values: {', '.join(VALID_THINKING_LEVELS)}",
+                    file=sys.stderr,
+                )
+        elif arg in ("--print", "-p"):
+            result["print"] = True
+        elif arg == "--export" and i + 1 < len(argv):
+            i += 1
+            result["export"] = argv[i]
+        elif arg in ("--extension", "-e") and i + 1 < len(argv):
+            i += 1
+            result.setdefault("extensions", []).append(argv[i])
+        elif arg in ("--no-extensions", "-ne"):
+            result["no_extensions"] = True
+        elif arg == "--skill" and i + 1 < len(argv):
+            i += 1
+            result.setdefault("skills", []).append(argv[i])
+        elif arg == "--prompt-template" and i + 1 < len(argv):
+            i += 1
+            result.setdefault("prompt_templates", []).append(argv[i])
+        elif arg == "--theme" and i + 1 < len(argv):
+            i += 1
+            result.setdefault("themes", []).append(argv[i])
+        elif arg in ("--no-skills", "-ns"):
+            result["no_skills"] = True
+        elif arg in ("--no-prompt-templates", "-np"):
+            result["no_prompt_templates"] = True
+        elif arg == "--no-themes":
+            result["no_themes"] = True
+        elif arg == "--list-models":
+            # Check if next arg is a search pattern (not a flag or file arg)
+            if i + 1 < len(argv) and not argv[i + 1].startswith("-") and not argv[i + 1].startswith("@"):
+                i += 1
+                result["list_models"] = argv[i]
+            else:
+                result["list_models"] = True
+        elif arg == "--verbose":
+            result["verbose"] = True
+        elif arg == "--offline":
+            result["offline"] = True
+        elif arg.startswith("@"):
+            result["file_args"].append(arg[1:])  # Remove @ prefix
+        elif arg.startswith("--") and extension_flags:
+            flag_name = arg[2:]
+            flag_type = extension_flags.get(flag_name)
+            if flag_type == "boolean":
+                result["unknown_flags"][flag_name] = True
+            elif flag_type == "string" and i + 1 < len(argv):
+                i += 1
+                result["unknown_flags"][flag_name] = argv[i]
+        elif not arg.startswith("-"):
+            result["messages"].append(arg)
+
+        i += 1
+
+    return result
+
+
+def print_help() -> None:
+    """Print help text."""
+    print(f"""{APP_NAME} - AI coding assistant with read, bash, edit, write tools
+
+Usage:
+  {APP_NAME} [options] [@files...] [messages...]
+
+Options:
+  --provider <name>              Provider name (default: google)
+  --model <pattern>              Model pattern or ID
+  --api-key <key>                API key
+  --system-prompt <text>         System prompt
+  --append-system-prompt <text>  Append to system prompt
+  --mode <mode>                  Output mode: text (default), json, rpc
+  --print, -p                    Non-interactive mode
+  --continue, -c                 Continue previous session
+  --resume, -r                   Select a session to resume
+  --session <path>               Use specific session file
+  --session-dir <dir>            Directory for session storage
+  --no-session                   Don't save session
+  --models <patterns>            Comma-separated model patterns for cycling
+  --no-tools                     Disable all built-in tools
+  --tools <tools>                Comma-separated list of tools to enable
+                                 Available: read, bash, edit, write, grep, find, ls
+  --thinking <level>             Set thinking level: off, minimal, low, medium, high, xhigh
+  --extension, -e <path>         Load an extension file
+  --no-extensions, -ne           Disable extension discovery
+  --skill <path>                 Load a skill file or directory
+  --no-skills, -ns               Disable skills discovery
+  --prompt-template <path>       Load a prompt template
+  --no-prompt-templates, -np     Disable prompt template discovery
+  --theme <path>                 Load a theme
+  --no-themes                    Disable theme discovery
+  --export <file>                Export session file to HTML and exit
+  --list-models [search]         List available models
+  --verbose                      Force verbose startup
+  --offline                      Disable startup network operations
+  --help, -h                     Show this help
+  --version, -v                  Show version number
+
+Examples:
+  # Interactive mode
+  {APP_NAME}
+
+  # Non-interactive mode
+  {APP_NAME} -p "List all .py files in src/"
+
+  # Include files in message
+  {APP_NAME} @prompt.md "What does this do?"
+
+  # Continue previous session
+  {APP_NAME} --continue "What did we discuss?"
+
+  # Use different model
+  {APP_NAME} --provider openai --model gpt-4o "Help me refactor"
+
+Environment Variables:
+  ANTHROPIC_API_KEY                - Anthropic Claude API key
+  OPENAI_API_KEY                   - OpenAI GPT API key
+  GEMINI_API_KEY                   - Google Gemini API key
+  {ENV_AGENT_DIR:<32} - Session storage directory (default: ~/{CONFIG_DIR_NAME}/agent)
+""")