agent-cli 0.70.5__py3-none-any.whl

agent_cli/dev/editors/jetbrains.py

@@ -0,0 +1,56 @@
+"""JetBrains IDE editor adapters."""
+
+from __future__ import annotations
+
+import os
+
+from .base import Editor
+
+
+class _JetBrainsEditor(Editor):
+    """Base class for JetBrains IDEs with common detection logic."""
+
+    def detect(self) -> bool:
+        """Detect if running inside a JetBrains IDE's terminal.
+
+        JetBrains IDEs set TERMINAL_EMULATOR=JetBrains-JediTerm.
+        Source: https://github.com/JetBrains/jediterm/issues/253
+        """
+        return os.environ.get("TERMINAL_EMULATOR") == "JetBrains-JediTerm"
+
+
+def _create_jetbrains_editor(
+    name: str,
+    command: str,
+    install_url: str,
+    alt_commands: tuple[str, ...] = (),
+) -> type[_JetBrainsEditor]:
+    """Factory to create JetBrains editor classes with minimal boilerplate."""
+
+    class _Editor(_JetBrainsEditor):
+        pass
+
+    _Editor.name = name
+    _Editor.command = command
+    _Editor.alt_commands = alt_commands
+    _Editor.install_url = install_url
+    _Editor.__name__ = name.replace("-", "_").title().replace("_", "")
+    _Editor.__qualname__ = _Editor.__name__
+    return _Editor
+
+
+# JetBrains IDE definitions: (name, command, url, alt_commands)
+_JETBRAINS_IDES = [
+    ("idea", "idea", "https://www.jetbrains.com/idea/", ()),
+    ("pycharm", "pycharm", "https://www.jetbrains.com/pycharm/", ("charm",)),
+    ("webstorm", "webstorm", "https://www.jetbrains.com/webstorm/", ()),
+    ("goland", "goland", "https://www.jetbrains.com/go/", ()),
+    ("rustrover", "rustrover", "https://www.jetbrains.com/rust/", ()),
+]
+
+# Generate editor classes
+IntelliJIdea = _create_jetbrains_editor(*_JETBRAINS_IDES[0])
+PyCharm = _create_jetbrains_editor(*_JETBRAINS_IDES[1])
+WebStorm = _create_jetbrains_editor(*_JETBRAINS_IDES[2])
+GoLand = _create_jetbrains_editor(*_JETBRAINS_IDES[3])
+RustRover = _create_jetbrains_editor(*_JETBRAINS_IDES[4])

agent_cli/dev/editors/nano.py

@@ -0,0 +1,31 @@
+"""Nano editor adapter."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from .base import Editor
+
+if TYPE_CHECKING:
+    from pathlib import Path
+
+
+class Nano(Editor):
+    """Nano - Simple terminal text editor."""
+
+    name = "nano"
+    command = "nano"
+    install_url = "https://www.nano-editor.org"
+    # Nano has no integrated terminal, detection always returns False (default)
+
+    def open_command(self, path: Path) -> list[str]:
+        """Return the command to open a directory in Nano.
+
+        Uses 'cd <path> && nano .' pattern to ensure nano's working
+        directory is set correctly.
+        """
+        exe = self.get_executable()
+        if exe is None:
+            msg = f"{self.name} is not installed"
+            raise RuntimeError(msg)
+        return ["sh", "-c", f'cd "{path}" && {exe} .']

agent_cli/dev/editors/neovim.py

@@ -0,0 +1,33 @@
+"""Neovim editor adapter."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from .base import Editor
+
+if TYPE_CHECKING:
+    from pathlib import Path
+
+
+class Neovim(Editor):
+    """Neovim - Hyperextensible Vim-based text editor."""
+
+    name = "neovim"
+    command = "nvim"
+    alt_commands = ("neovim",)
+    install_url = "https://neovim.io"
+    detect_env_vars = ("NVIM",)
+    # No detect_term_program - Neovim doesn't set TERM_PROGRAM (uses $NVIM)
+
+    def open_command(self, path: Path) -> list[str]:
+        """Return the command to open a directory in Neovim.
+
+        Uses 'cd <path> && nvim .' pattern to ensure neovim's working
+        directory is set correctly (matches GTR behavior).
+        """
+        exe = self.get_executable()
+        if exe is None:
+            msg = f"{self.name} is not installed"
+            raise RuntimeError(msg)
+        return ["sh", "-c", f'cd "{path.as_posix()}" && {exe} .']

agent_cli/dev/editors/registry.py

@@ -0,0 +1,59 @@
+"""Registry for editor adapters."""
+
+from __future__ import annotations
+
+from agent_cli.dev.registry import Registry
+
+from .base import Editor  # noqa: TC001
+from .cursor import Cursor
+from .emacs import Emacs
+from .jetbrains import GoLand, IntelliJIdea, PyCharm, RustRover, WebStorm
+from .nano import Nano
+from .neovim import Neovim
+from .sublime import SublimeText
+from .vim import Vim
+from .vscode import VSCode
+from .zed import Zed
+
+# All available editors (in priority order for detection)
+_EDITORS: list[type[Editor]] = [
+    # Modern AI-focused editors first
+    Cursor,
+    VSCode,
+    Zed,
+    # JetBrains IDEs
+    PyCharm,
+    IntelliJIdea,
+    WebStorm,
+    GoLand,
+    RustRover,
+    # Terminal editors
+    Neovim,
+    Vim,
+    Nano,
+    Emacs,
+    # Other GUI editors
+    SublimeText,
+]
+
+_registry: Registry[Editor] = Registry(_EDITORS)
+
+
+def get_all_editors() -> list[Editor]:
+    """Get instances of all registered editors."""
+    return _registry.get_all()
+
+
+def get_available_editors() -> list[Editor]:
+    """Get all installed/available editors."""
+    return _registry.get_available()
+
+
+def detect_current_editor() -> Editor | None:
+    """Detect which editor's integrated terminal we're running in."""
+    return _registry.detect_current()
+
+
+def get_editor(name: str) -> Editor | None:
+    """Get an editor by name."""
+    return _registry.get_by_name(name)

agent_cli/dev/editors/sublime.py

@@ -0,0 +1,20 @@
+"""Sublime Text editor adapter."""
+
+from __future__ import annotations
+
+from .base import Editor
+
+
+class SublimeText(Editor):
+    """Sublime Text - A sophisticated text editor for code.
+
+    Note: Sublime Text does not have a built-in integrated terminal.
+    Terminal packages (like Terminus) may be used but don't set
+    specific environment variables for detection.
+    """
+
+    name = "sublime"
+    command = "subl"
+    alt_commands = ("sublime_text", "sublime")
+    install_url = "https://www.sublimetext.com"
+    # No detect_term_program - Sublime has no native integrated terminal

agent_cli/dev/editors/vim.py

@@ -0,0 +1,42 @@
+"""Vim editor adapter."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from .base import Editor
+
+if TYPE_CHECKING:
+    from pathlib import Path
+
+
+class Vim(Editor):
+    """Vim - The ubiquitous text editor.
+
+    Note: Vim does not have an integrated terminal in the traditional sense.
+    VIM and VIMRUNTIME env vars are used BY vim to locate runtime files,
+    NOT set to indicate running inside vim. Detection always returns False.
+
+    Evidence: https://vimdoc.sourceforge.net/htmldoc/starting.html
+    Quote: "The environment variable '$VIM' is used to locate various user
+           files for Vim" and "$VIMRUNTIME is used to locate various support
+           files, such as the on-line documentation"
+    """
+
+    name = "vim"
+    command = "vim"
+    alt_commands = ("vi",)
+    install_url = "https://www.vim.org"
+    # No detection - vim has no integrated terminal that sets env vars
+
+    def open_command(self, path: Path) -> list[str]:
+        """Return the command to open a directory in Vim.
+
+        Uses 'cd <path> && vim .' pattern to ensure vim's working
+        directory is set correctly (matches GTR behavior).
+        """
+        exe = self.get_executable()
+        if exe is None:
+            msg = f"{self.name} is not installed"
+            raise RuntimeError(msg)
+        return ["sh", "-c", f'cd "{path.as_posix()}" && {exe} .']

agent_cli/dev/editors/vscode.py

@@ -0,0 +1,15 @@
+"""VS Code editor adapter."""
+
+from __future__ import annotations
+
+from .base import Editor
+
+
+class VSCode(Editor):
+    """Visual Studio Code editor."""
+
+    name = "vscode"
+    command = "code"
+    alt_commands = ("code-insiders",)
+    install_url = "https://code.visualstudio.com"
+    detect_term_program = "vscode"

agent_cli/dev/editors/zed.py

@@ -0,0 +1,20 @@
+"""Zed editor adapter."""
+
+from __future__ import annotations
+
+from .base import Editor
+
+
+class Zed(Editor):
+    """Zed - A high-performance, multiplayer code editor.
+
+    Detection via ZED_TERM=true (source code) or TERM_PROGRAM=zed (v0.145.0+).
+    """
+
+    name = "zed"
+    command = "zed"
+    install_url = "https://zed.dev"
+    # ZED_TERM=true set in terminal.rs insert_zed_terminal_env()
+    detect_env_vars = ("ZED_TERM",)
+    # TERM_PROGRAM=zed added in v0.145.0 (PR #14213)
+    detect_term_program = "zed"