just-cli 0.3.0__tar.gz → 0.3.1__tar.gz

just_cli-0.3.1/.claude/plans/2026-04-18-edit-installer-macos-micro.md

@@ -0,0 +1,237 @@
+# Edit Installer: macOS Support with micro Implementation Plan
+
+> **For agentic workers:** REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Add macOS support to `just install edit` by installing the `micro` text editor
+
+**Architecture:** Platform-specific branching in installer function - Windows/Linux continue using Microsoft Edit, macOS uses micro with symlink from `edit` to `micro`.
+
+**Tech Stack:** Python 3.10+, typer, just installer framework
+
+---
+
+## File Structure
+
+**Files to modify:**
+- `src/just/installers/edit/installer.py` - Main installer implementation
+
+**No new files needed.**
+
+---
+
+## Chunk 1: Update installer.py with macOS micro support
+
+### Task 1: Modify version parameter and add platform detection
+
+**Files:**
+- Modify: `src/just/installers/edit/installer.py`
+
+- [ ] **Step 1: Update the version parameter default**
+
+Change the `version` parameter default from `"1.2.0"` to `None`:
+
+```python
+def install_edit(
+    version: just.Annotated[
+        str, just.Option("-v", "--version", help="The version of Edit to install.")
+    ] = None,  # Changed from "1.2.0"
+):
+```
+
+- [ ] **Step 2: Add version resolution logic**
+
+Add platform-specific default version after the function definition:
+
+```python
+    # Resolve default version based on platform
+    if version is None:
+        if just.system.platform == "darwin":
+            version = "2.0.15"  # micro latest stable
+        else:
+            version = "1.2.0"  # Microsoft Edit
+```
+
+- [ ] **Step 3: Update docstring**
+
+Update the docstring to reflect macOS support:
+
+```python
+    """
+    Install a terminal text editor.
+
+    - Windows/Linux: Microsoft Edit
+    - macOS: micro (with 'edit' symlink)
+    """
+```
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add src/just/installers/edit/installer.py
+git commit -m "feat(edit): add version parameter resolution for platform defaults"
+```
+
+---
+
+### Task 2: Add macOS branch with micro installation
+
+**Files:**
+- Modify: `src/just/installers/edit/installer.py`
+
+- [ ] **Step 1: Add macOS platform branch**
+
+Add the `elif just.system.platform == "darwin":` branch before the `else` clause:
+
+```python
+    elif just.system.platform == "darwin":
+        # Install micro text editor for macOS
+        editor_name = "micro"
+        url = f"https://github.com/zyedidia/micro/releases/download/v{version}/micro-{version}-{just.system.arch}-darwin.tar.gz"
+
+        just.echo.info(f"Installing {editor_name} v{version} as the default editor...")
+
+        just.ArchiveInstaller(
+            url=url,
+            executables=["micro"],
+            name="micro",
+        ).run()
+```
+
+- [ ] **Step 2: Add edit -> micro symlink creation**
+
+After the `ArchiveInstaller().run()` call in the macOS branch, add symlink creation:
+
+```python
+        # Create edit -> micro symlink for consistency
+        from just.core.installer.utils import create_symlink_or_wrapper
+        from just.core.config.utils import get_bin_dir
+
+        micro_path = get_bin_dir() / "micro"
+        create_symlink_or_wrapper(
+            target=micro_path,
+            link_dir=get_bin_dir(),
+            link_name="edit"
+        )
+```
+
+- [ ] **Step 3: Add info log for Windows/Linux branches**
+
+Add `just.echo.info()` calls before `ArchiveInstaller().run()` in Windows and Linux branches:
+
+```python
+        just.echo.info(f"Installing Microsoft Edit v{version} as the default editor...")
+```
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add src/just/installers/edit/installer.py
+git commit -m "feat(edit): add macOS support with micro editor"
+```
+
+---
+
+### Task 3: Update installer decorator check command
+
+**Files:**
+- Modify: `src/just/installers/edit/installer.py`
+
+- [ ] **Step 1: Update check command for platform detection**
+
+The current `@just.installer(check="edit -v")` won't work for macOS since we install micro first.
+Update to use a dynamic check or remove the check parameter for now:
+
+```python
+@just.installer(check="edit --version")  # Works for both after symlink is created
+```
+
+Note: `micro --version` works, and after symlink `edit --version` will invoke micro.
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add src/just/installers/edit/installer.py
+git commit -m "fix(edit): update check command to work with micro"
+```
+
+---
+
+## Chunk 2: Testing
+
+### Task 4: Manual testing on macOS
+
+**Files:**
+- None (manual testing)
+
+- [ ] **Step 1: Test macOS installation**
+
+Run on macOS:
+```bash
+just install edit
+```
+
+Expected output:
+```
+Installing micro v2.0.15 as the default editor...
+...
+Installing micro v2.0.15 as the default editor...
+```
+
+- [ ] **Step 2: Verify edit command works**
+
+```bash
+edit --version
+```
+
+Expected: micro version output
+
+- [ ] **Step 3: Verify symlink exists**
+
+```bash
+ls -la ~/.just/bin/edit
+```
+
+Expected: symlink pointing to micro
+
+- [ ] **Step 4: Test version override**
+
+```bash
+just install edit -v 2.0.14
+```
+
+Expected: installs specified micro version
+
+---
+
+### Task 5: Verify existing platforms unchanged
+
+**Files:**
+- None (manual testing on Windows/Linux)
+
+- [ ] **Step 1: Test default behavior**
+
+```bash
+just install edit
+```
+
+Expected: installs Microsoft Edit v1.2.0
+
+- [ ] **Step 2: Test version override**
+
+```bash
+just install edit -v 1.1.0
+```
+
+Expected: installs specified Microsoft Edit version
+
+---
+
+## Final State
+
+After implementation, `just install edit` will:
+
+| Platform | Editor | Default Version | Command Available |
+|----------|--------|-----------------|-------------------|
+| macOS | micro | 2.0.15 | `edit` (-> micro) |
+| Windows | Microsoft Edit | 1.2.0 | `edit` |
+| Linux | Microsoft Edit | 1.2.0 | `edit` |

just_cli-0.3.1/.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+      "mcp__web-search-prime__web_search_prime",
+      "mcp__web-reader__webReader",
+      "mcp__context7__query-docs"
+    ]
+  }
+}

{just_cli-0.3.0 → just_cli-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: just-cli
-Version: 0.3.0
+Version: 0.3.1
 Summary: Your all-in-one CLI Toolkit
 Author-email: zzzcb <zjxs.zzzcb@gmail.com>
 Requires-Python: >=3.10

{just_cli-0.3.0 → just_cli-0.3.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "just-cli"
-version = "0.3.0"
+version = "0.3.1"
 description = "Your all-in-one CLI Toolkit"
 readme = "README.md"
 authors = [

{just_cli-0.3.0 → just_cli-0.3.1}/src/just/commands/workspace.py

@@ -1,4 +1,7 @@
 from pathlib import Path
+from typing_extensions import Annotated
+
+import typer
 
 from just import just_cli, capture_exception
 from just.tui.workspace import WorkspaceApp
@@ -7,12 +10,12 @@ from just.tui.workspace import WorkspaceApp
 @just_cli.command(name="code")
 @capture_exception
 def workspace_command(
-    path: str = ".",
+    workdir: Annotated[str, typer.Argument(help="Working directory")] = ".",
 ):
     """
     Open a VSCode-style workspace editor.
     """
-    workspace_path = Path(path).resolve()
+    workspace_path = Path(workdir).resolve()
     if not workspace_path.exists():
         print(f"Error: Path does not exist: {workspace_path}")
         return

just_cli-0.3.1/src/just/installers/edit/installer.py

@@ -0,0 +1,72 @@
+import just
+
+from just.core.installer.utils import create_symlink_or_wrapper
+from just.core.config.utils import get_bin_dir
+
+
+@just.installer(check="edit -v")
+def install_edit(
+    version: just.Annotated[
+        str, just.Option("-v", "--version", help="The version of Edit to install.")
+    ] = None,
+):
+    """
+    Install a terminal text editor.
+
+    - Windows/Linux: Microsoft Edit
+    - macOS: micro (with 'edit' symlink)
+    """
+    # Resolve default version based on platform
+    if version is None:
+        if just.system.platform == "darwin":
+            version = "2.0.15"  # micro latest stable
+        else:
+            version = "1.2.0"  # Microsoft Edit
+
+    if just.system.platform == "windows":
+        just.echo.info(f"Installing Microsoft Edit v{version} as the default editor...")
+        url = f"https://github.com/microsoft/edit/releases/download/v{version}/edit-{version}-{just.system.arch}-windows.zip"
+        just.ArchiveInstaller(
+            url=url,
+            executables=["edit.exe"],
+            name="edit",
+        ).run()
+    elif just.system.platform == "linux":
+        just.echo.info(f"Installing Microsoft Edit v{version} as the default editor...")
+        url = f"https://github.com/microsoft/edit/releases/download/v{version}/edit-{version}-{just.system.arch}-linux-gnu.tar.zst"
+        just.ArchiveInstaller(
+            url,
+            executables=["edit"],
+            name="edit",
+        ).run()
+    elif just.system.platform == "darwin":
+        # Install micro text editor for macOS
+        editor_name = "micro"
+        # Map architecture to micro's platform naming
+        micro_platform = "macos-arm64" if just.system.arch == "aarch64" else "osx"
+        url = f"https://github.com/micro-editor/micro/releases/download/v{version}/micro-{version}-{micro_platform}.tar.gz"
+
+        just.echo.info(f"Installing {editor_name} v{version} as the default editor...")
+
+        just.ArchiveInstaller(
+            url=url,
+            executables=["micro"],
+            name="micro",
+        ).run()
+
+        # Create edit -> micro symlink for consistency
+        micro_path = get_bin_dir() / "micro"
+
+        # Verify micro was installed successfully before creating symlink
+        if not micro_path.exists():
+            raise RuntimeError(f"micro installation failed - executable not found at {micro_path}")
+
+        create_symlink_or_wrapper(
+            target=micro_path,
+            link_dir=get_bin_dir(),
+            link_name="edit"
+        )
+    else:
+        raise NotImplementedError(
+            f"No editor is available for {just.system.platform}."
+        )

{just_cli-0.3.0 → just_cli-0.3.1}/src/just/tui/workspace.py

@@ -1,12 +1,106 @@
 """Minimal workspace editor with file tree and editor"""
 
 from pathlib import Path
+from typing import Iterable
 
 from textual.app import App, ComposeResult
 from textual.binding import Binding
 from textual.containers import Horizontal, Vertical
 from textual.screen import ModalScreen
-from textual.widgets import DirectoryTree, TextArea, Input, Button, Label
+from textual.widgets import DirectoryTree, TextArea, Input, Button, Label, Footer
+from rich.text import Text
+
+
+class IconDirectoryTree(DirectoryTree):
+    """DirectoryTree with custom file type icons."""
+
+    # File icon mapping by extension
+    FILE_ICONS: dict[str, str] = {
+        # Python
+        ".py": "🐍",
+        # JavaScript/TypeScript
+        ".js": "📜",
+        ".ts": "📜",
+        ".jsx": "📜",
+        ".tsx": "📜",
+        # Config files
+        ".json": "⚙️",
+        ".yaml": "⚙️",
+        ".yml": "⚙️",
+        ".toml": "⚙️",
+        ".xml": "⚙️",
+        ".ini": "⚙️",
+        ".conf": "⚙️",
+        ".cfg": "⚙️",
+        # Markdown
+        ".md": "📝",
+        ".markdown": "📝",
+        # Text
+        ".txt": "📄",
+        # Styles
+        ".css": "🎨",
+        ".scss": "🎨",
+        ".sass": "🎨",
+        ".less": "🎨",
+        # HTML
+        ".html": "🌐",
+        ".htm": "🌐",
+        # Shell
+        ".sh": "🖥️",
+        ".bash": "🖥️",
+        ".zsh": "🖥️",
+        ".fish": "🖥️",
+        # Rust
+        ".rs": "🦀",
+        # Go
+        ".go": "🐹",
+        # Java
+        ".java": "☕",
+        # C/C++
+        ".c": "🏗️",
+        ".cpp": "🏗️",
+        ".h": "🏗️",
+        ".hpp": "🏗️",
+        ".cc": "🏗️",
+        ".cxx": "🏗️",
+        # Other common files
+        ".lock": "🔒",
+        ".gitignore": "🙈",
+        ".env": "🔐",
+        "dockerfile": "🐳",
+        "dockerignore": "🐳",
+        "makefile": "🛠️",
+        # Fallback
+        "": "📄",
+    }
+
+    def render_label(
+        self, node, base_style: str, style: str
+    ) -> Text:
+        """Render label with custom icon based on file extension."""
+        if node.data is None:
+            return Text("")
+
+        # node.data is DirEntry, which has a path attribute
+        entry = node.data
+        path = entry.path
+
+        if path.is_dir():
+            # Folder icon
+            return Text(f"📁 {path.name}")
+
+        # Get file extension
+        ext = path.suffix.lower()
+        name_lower = path.name.lower()
+
+        # Check for special files by name
+        if name_lower in self.FILE_ICONS:
+            icon = self.FILE_ICONS[name_lower]
+        else:
+            # Check by extension
+            icon = self.FILE_ICONS.get(ext, self.FILE_ICONS[""])
+
+        return Text(f"{icon} {path.name}")
 
 
 class InputDialog(ModalScreen[str]):
@@ -160,8 +254,8 @@ class WorkspaceApp(App):
     BINDINGS = [
         Binding("ctrl+s", "save", "Save"),
         Binding("ctrl+n", "new", "New"),
-        Binding("d", "delete", "Delete"),
-        Binding("q", "quit", "Quit"),
+        Binding("ctrl+d", "delete", "Delete"),
+        Binding("escape", "quit", "ESC"),
     ]
 
     def __init__(self, path: str = "."):
@@ -172,8 +266,9 @@ class WorkspaceApp(App):
     def compose(self) -> ComposeResult:
         with Horizontal():
             with Vertical(id="sidebar"):
-                yield DirectoryTree(self.workspace_path)
+                yield IconDirectoryTree(self.workspace_path)
             yield CodeEditor(Path("/dev/null"), id="editor")
+        yield Footer()
 
     def on_mount(self) -> None:
         self.title = str(self.workspace_path)
@@ -201,13 +296,11 @@ class WorkspaceApp(App):
     def _create_note(self, name: str) -> None:
         if not name:
             return
-        if not name.endswith(".md"):
-            name += ".md"
         file_path = self.workspace_path / name
         if file_path.exists():
             self.notify("File already exists", severity="error")
             return
-        file_path.write_text(f"# {name[:-3]}\n\n", encoding="utf-8")
+        file_path.write_text("", encoding="utf-8")
         self._refresh_tree()
         self._open_file(file_path)
 
@@ -233,7 +326,7 @@ class WorkspaceApp(App):
             self.notify("Deleted")
 
     def _refresh_tree(self) -> None:
-        tree = self.query_one(DirectoryTree)
+        tree = self.query_one(IconDirectoryTree)
         tree.reload()
 
     def _open_file(self, file_path: Path) -> None:

just_cli-0.3.0/.claude/settings.local.json

@@ -1,7 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "mcp__web-search-prime__web_search_prime"
-    ]
-  }
-}

just_cli-0.3.0/src/just/installers/edit/installer.py

@@ -1,31 +0,0 @@
-import just
-
-
-@just.installer(check="edit -v")
-def install_edit(
-    version: just.Annotated[
-        str, just.Option("-v", "--version", help="The version of Edit to install.")
-    ] = "1.2.0",
-):
-    """
-    Install Microsoft Edit.
-    """
-
-    if just.system.platform == "windows":
-        url = f"https://github.com/microsoft/edit/releases/download/v{version}/edit-{version}-{just.system.arch}-windows.zip"
-        just.ArchiveInstaller(
-            url=url,
-            executables=["edit.exe"],
-            name="edit",
-        ).run()
-    elif just.system.platform == "linux":
-        url = f"https://github.com/microsoft/edit/releases/download/v{version}/edit-{version}-{just.system.arch}-linux-gnu.tar.zst"
-        just.ArchiveInstaller(
-            url,
-            executables=["edit"],
-            name="edit",
-        ).run()
-    else:
-        raise NotImplementedError(
-            f"Microsoft Edit is not supported on {just.system.platform}."
-        )