kash-shell 0.3.24__py3-none-any.whl → 0.3.26__py3-none-any.whl

kash/commands/help/assistant_commands.py

@@ -1,7 +1,8 @@
 from kash.commands.base.basic_file_commands import trash
 from kash.commands.workspace.selection_commands import select
-from kash.config.logger import get_console, get_logger
-from kash.config.text_styles import PROMPT_ASSIST, SPINNER
+from kash.config.logger import get_logger
+from kash.config.text_styles import PROMPT_ASSIST
+from kash.config.unified_live import get_unified_live
 from kash.docs.all_docs import DocSelection
 from kash.exec import kash_command
 from kash.exec_model.shell_model import ShellResult
@@ -43,7 +44,7 @@ def assist(
             help()
             return
 
-    with get_console().status("Thinking…", spinner=SPINNER):  # noqa: F821
+    with get_unified_live().status("Thinking…"):
         shell_context_assistance(input, model=model, assistance_type=type)
 
 

kash/config/colors.py

@@ -135,11 +135,12 @@ web_light_translucent = SimpleNamespace(
     secondary=hsl_to_hex("hsl(188, 12%, 28%)"),
     tertiary=hsl_to_hex("hsl(188, 7%, 64%)"),
     bg=hsl_to_hex("hsla(44, 6%, 100%, 0.75)"),
-    bg_solid=hsl_to_hex("hsla(44, 6%, 100%, 1)"),
+    bg_solid=hsl_to_hex("hsl(44, 6%, 100%)"),
     bg_header=hsl_to_hex("hsla(188, 42%, 70%, 0.2)"),
     bg_alt=hsl_to_hex("hsla(39, 24%, 90%, 0.3)"),
-    bg_alt_solid=hsl_to_hex("hsla(39, 24%, 97%, 1)"),
-    bg_meta_solid=hsl_to_hex("hsla(39, 24%, 94%, 1)"),
+    bg_alt_solid=hsl_to_hex("hsl(39, 24%, 97%)"),
+    bg_meta_solid=hsl_to_hex("hsl(39, 24%, 94%)"),
+    bg_strong_solid=hsl_to_hex("hsl(39, 8%, 90%)"),
     bg_selected=hsl_to_hex("hsla(188, 21%, 94%, 0.9)"),
     text=hsl_to_hex("hsl(188, 39%, 11%)"),
     code=hsl_to_hex("hsl(44, 38%, 23%)"),
@@ -174,6 +175,7 @@ web_dark_translucent = SimpleNamespace(
     bg_alt=hsl_to_hex("hsla(220, 14%, 12%, 0.5)"),
     bg_alt_solid=hsl_to_hex("hsl(220, 15%, 16%)"),
     bg_meta_solid=hsl_to_hex("hsl(220, 14%, 25%)"),
+    bg_strong_solid=hsl_to_hex("hsl(220, 14%, 35%)"),
     bg_selected=hsl_to_hex("hsla(188, 13%, 33%, 0.95)"),
     text=hsl_to_hex("hsl(188, 10%, 90%)"),
     code=hsl_to_hex("hsl(44, 38%, 72%)"),

kash/config/text_styles.py

@@ -57,6 +57,7 @@ COLOR_PLAIN = "default"
 COLOR_LINK = "cyan"
 COLOR_SUCCESS = "green"
 COLOR_FAILURE = "bright_red"
+COLOR_SPINNER = "bright_cyan"
 COLOR_WARN = "bright_red"
 COLOR_ERROR = "bright_red"
 COLOR_EXTRA = "bright_blue"

kash/config/unified_live.py

@@ -0,0 +1,251 @@
+from __future__ import annotations
+
+import atexit
+import threading
+import time
+from collections.abc import Generator
+from contextlib import contextmanager
+from dataclasses import dataclass, field
+
+from rich.console import Console, RenderableType
+from rich.live import Live
+from rich.spinner import Spinner
+from rich.text import Text
+from rich.console import Group
+from strif import AtomicVar
+
+from kash.config.logger import get_console
+from kash.config.text_styles import SPINNER, COLOR_SPINNER
+
+
+@dataclass
+class LiveContent:
+    """
+    Container for different types of live-updating status content.
+    """
+
+    current_status: str | None = None  # Single current status message
+    multitask_display: RenderableType | None = None
+    custom_content: list[RenderableType] = field(default_factory=list)
+
+
+class UnifiedLive:
+    """
+    Unified live display manager that handles all Rich live content in a single Live container.
+
+    This eliminates Rich's one-live-display-at-a-time limitation by
+    providing a single Live that all other components render into.
+
+    Layout structure:
+    - Status message at the top (single spinner and message)
+    - MultiTask progress displays in the middle
+    - Custom live content at the bottom
+    """
+
+    def __init__(
+        self,
+        *,
+        console: Console | None = None,
+        transient: bool = True,
+        refresh_per_second: float = 10,
+    ):
+        self.console = console or get_console()
+        self._content = LiveContent()
+        self._live = Live(
+            console=self.console,
+            transient=transient,
+            refresh_per_second=refresh_per_second,
+        )
+        self._is_active = False
+        self._lock = threading.RLock()  # Thread safety for mutable state
+        self._usage_count = 0  # Track how many things are using this live display
+
+    def start(self) -> None:
+        """Start the unified live display."""
+        with self._lock:
+            if self._is_active:
+                return
+
+            try:
+                self._live.__enter__()
+                self._is_active = True
+                self._update_display()
+            except Exception:
+                # If starting fails, ensure we're in a clean state
+                self._is_active = False
+                raise
+
+    def stop(self) -> None:
+        """Stop the unified live display and restore terminal state."""
+        with self._lock:
+            if not self._is_active:
+                return
+
+            self._is_active = False
+            try:
+                self._live.__exit__(None, None, None)
+            except Exception:
+                # Always try to restore terminal state even if Live cleanup fails
+                pass
+            finally:
+                # Force terminal state restoration
+                try:
+                    # Ensure cursor is visible and terminal is in normal state
+                    self.console.show_cursor()
+                    if hasattr(self.console, "_buffer"):
+                        self.console._buffer.clear()
+                except Exception:
+                    pass
+
+    def _increment_usage(self) -> None:
+        """Increment usage counter (called when entering a context)."""
+        with self._lock:
+            self._usage_count += 1
+
+    def _decrement_usage(self) -> None:
+        """Decrement usage counter and stop if unused (called when exiting a context)."""
+        with self._lock:
+            self._usage_count = max(0, self._usage_count - 1)
+            # Auto-stop if nothing is using it and it has content that would be cleared anyway
+            if self._usage_count == 0 and self._content.current_status is None:
+                self.stop()
+
+    def set_status(self, message: str | None) -> None:
+        """Set the current status message (or None to clear it)."""
+        with self._lock:
+            self._content.current_status = message
+            self._update_display()
+
+    @contextmanager
+    def status(self, message: str, *, spinner: str = SPINNER) -> Generator[None, None, None]:  # pyright: ignore[reportUnusedParameter]
+        """
+        Context manager for showing a status message in this unified live display.
+
+        Args:
+            message: Status message to display
+            spinner: Spinner type (for future animation support)
+        """
+        self._increment_usage()
+        self.set_status(message)
+        try:
+            yield
+        finally:
+            self.set_status(None)
+            self._decrement_usage()
+
+    def set_multitask_display(self, display: RenderableType | None) -> None:
+        """Set the multitask progress display content."""
+        with self._lock:
+            self._content.multitask_display = display
+            self._update_display()
+
+    def add_custom_content(self, content: RenderableType) -> int:
+        """Add custom live content. Returns an ID for later removal."""
+        with self._lock:
+            self._content.custom_content.append(content)
+            self._update_display()
+            return len(self._content.custom_content) - 1
+
+    def remove_custom_content(self, content_id: int) -> None:
+        """Remove custom content by ID."""
+        with self._lock:
+            if 0 <= content_id < len(self._content.custom_content):
+                del self._content.custom_content[content_id]
+                self._update_display()
+
+    def _update_display(self) -> None:
+        """Update the live display with current content. Must be called with lock held."""
+        if not self._is_active:
+            return
+
+        renderables: list[RenderableType] = []
+
+        # Add multitask display at the top
+        if self._content.multitask_display is not None:
+            renderables.append(self._content.multitask_display)
+
+        # Add custom content in the middle
+        renderables.extend(self._content.custom_content)
+
+        # Add current status message with animated spinner at the bottom
+        if self._content.current_status is not None:
+            from rich.columns import Columns
+
+            spinner = Spinner(SPINNER, style=COLOR_SPINNER)
+            status_text = Text(self._content.current_status)
+
+            # Use Columns to display spinner and message side by side
+            status_line = Columns([spinner, status_text], padding=(0, 1))
+            renderables.append(status_line)
+
+        # Update the live display - use Group to stack vertically
+        if renderables:
+            self._live.update(Group(*renderables))
+        else:
+            # Show empty space if no content
+            self._live.update("")
+
+    @property
+    def is_active(self) -> bool:
+        """Check if this unified live is currently active."""
+        with self._lock:
+            return self._is_active
+
+
+# Global unified live instance, auto-initialized on first access (thread-safe)
+_global_unified_live = AtomicVar[UnifiedLive | None](None)
+
+
+def _cleanup_unified_live() -> None:
+    """Clean up the global unified live display on process exit."""
+    current = _global_unified_live.value
+    if current is not None:
+        current.stop()
+
+
+# Register cleanup handler for normal exit only
+atexit.register(_cleanup_unified_live)
+
+
+def get_unified_live() -> UnifiedLive:
+    """
+    Get the global unified live display, auto-initializing if needed.
+
+    Always returns a valid UnifiedLive instance. Creates and starts one
+    automatically if none exists yet. Thread-safe using AtomicVar.
+    """
+    with _global_unified_live.lock:
+        if not _global_unified_live:
+            live = UnifiedLive()
+            live.start()
+            _global_unified_live.set(live)
+
+    result = _global_unified_live.value
+    assert result
+    return result
+
+
+def has_unified_live() -> bool:
+    """Check if there's currently an active unified live display."""
+    current = _global_unified_live.value
+    return current is not None and current.is_active
+
+
+@contextmanager
+def unified_live_context(
+    console: Console | None = None,
+) -> Generator[UnifiedLive, None, None]:
+    """
+    Context manager for working with the unified live display.
+
+    Returns the global unified live instance, creating and starting it if needed.
+    The live display continues running after this context exits.
+    """
+    # Always return the global instance, creating if needed
+    live = get_unified_live()
+
+    # Update settings if this is a new instance
+    if console is not None:
+        live.console = console
+
+    yield live

kash/docs/markdown/assistant_instructions_template.md

@@ -5,7 +5,7 @@ organizing knowledge.
 Kash can be used as a shell, with access to common commands like `ps` and `cd`, but has
 far more capabilities and can generate and manipulate text documents, videos, and more.
 
-Kash is written in Python, runs on a user's own computer.
+Kash is written in Python, runs on a user’s own computer.
 It can connect to the web to download or read content or use LLM-based tools and APIs
 such as ones from OpenAI or Anthropic.
 It saves all content and state to files.
@@ -69,7 +69,7 @@ necessary.
 
 Always follow these guidelines:
 
-- If you're unsure of what command might help, simply say "I'm not sure how to help with
+- If you’re unsure of what command might help, simply say "I’m not sure how to help with
   that. Run `help` for more about kash.`" Suggest the user run `help` to get more
   information themselves.
 
@@ -81,7 +81,7 @@ Always follow these guidelines:
 
 - If there is more than one command that might be relevant, mention all the commands
   that might be of interest.
-  Don't repeatedly mention the same command.
+  Don’t repeatedly mention the same command.
   Be brief!
 
 - If they ask for a task that is not covered by the current set of actions, you may

kash/docs/markdown/topics/a1_what_is_kash.md

@@ -8,15 +8,15 @@ exploratory, and flexible using Python and current AI tools.
 
 The philosophy behind kash is similar to Unix shell tools: simple commands that can be
 combined in flexible and powerful ways.
-It operates on "items" such as URLs, files, or Markdown notes within a workspace
+It operates on “items” such as URLs, files, or Markdown notes within a workspace
 directory.
 
 You can use Kash as an **interactive, AI-native command-line** shell for practical
-knowledge tasks. It's also **a Python library** that lets you convert a simple Python
+knowledge tasks. It’s also **a Python library** that lets you convert a simple Python
 function into a command and an MCP tool, so it integrates with other tools like
 Anthropic Desktop or Cursor.
 
-It's new and still has some rough edges, but it's now working well enough it is feeling
+It’s new and still has some rough edges, but it’s now working well enough it is feeling
 quite powerful. It now serves as a replacement for my usual shell (previously bash or
 zsh). I use it routinely to remix, combine, and interactively explore and then gradually
 automate complex tasks by composing AI tools, APIs, and libraries.
@@ -48,19 +48,20 @@ quick to install via uv.
   context of a **workspace**. A workspace is just a directory of files that have a few
   conventions to make it easier to maintain context and perform actions.
   A bit like how Git repos work, it has a `.kash/` directory that holds metadata and
-  cached content. The rest can be anything, but is typically directories of resources
-  (like .docx or .pdf or links to web pages) or content, typically Markdown files with
-  YAML frontmatter. All text files use
-  [frontmatter-format](https://github.com/jlevy/frontmatter-format) so have easy-to-read
-  YAML metadata that includes not just title or description, but also the names of the
-  actions that created it.
+  cached content. The rest can be anything, but is typically directories of content and
+  resources (often Markdown or HTML but also .docx or .pdf or links to web pages).
+  All text files use [frontmatter-format](https://github.com/jlevy/frontmatter-format)
+  so have YAML metadata that includes not just title or description, but also how it was
+  created. All Markdown files are auto-formatted with
+  [flowmark](https://github.com/jlevy/flowmark), which makes documents much easier to
+  diff and version control (and prettier to read and edit).
 
 - **Compositionality:** An action is composable with other actions simply as a Python
   function, so complex operations (for example, transcribing and annotating a video and
   publishing it on a website) actions can be built from simpler actions (say downloading
   and caching a YouTube video, identifying the speakers in a transcript, formatting it
-  as pretty HTML, etc.). The goal is to reduce the "interstitial complexity" of
-  combining tools, so it's easy for you (or an LLM!) to combine tools in flexible and
+  as pretty HTML, etc.). The goal is to reduce the “interstitial complexity” of
+  combining tools, so it’s easy for you (or an LLM!) to combine tools in flexible and
   powerful ways.
 
 - **Command-line usage:** In addition to using the function in other libraries and
@@ -87,16 +88,16 @@ transcripts and notes, write blog posts, extract or visualize concepts, check ci
 convert notes to PDFs or beautifully formatted HTML, or perform numerous other
 content-related tasks possible by orchestrating AI tools in the right ways.
 
-As I've been building kash over the past couple months, I found I've found it's not only
+As I’ve been building kash over the past couple months, I found I’ve found it’s not only
 faster to do complex things, but that it has also become replacement for my usual shell.
-It's the power-tool I want to use alongside Cursor and ChatGPT/Claude.
+It’s the power-tool I want to use alongside Cursor and ChatGPT/Claude.
 We all know and trust shells like bash, zsh, and fish, but now I find this is much more
 powerful for everyday usage.
 It has little niceties, like you can just type `files` for a better listing of files or
 `show` and it will show you a file the right way, no matter what kind of file it is.
-You can also type something like "? find md files" and press tab and it will list you I
+You can also type something like “? find md files” and press tab and it will list you I
 find it is much more powerful for local usage than than bash/zsh/fish.
-If you're a command-line nerd, you might like it a lot.
+If you’re a command-line nerd, you might like it a lot.
 
 But my hope is that with these enhancements, the shell is also far more friendly and
 usable by anyone reasonably technical, and does not feel so esoteric as a typical Unix
@@ -105,16 +106,17 @@ shell.
 Finally, one more thing: Kash is also my way of experimenting with something else new: a
 **terminal GUI support** that adds GUI features terminal like clickable text, buttons,
 tooltips, and popovers in the terminal.
-I've separately built a new desktop terminal app, Kerm, which adds support for a simple
-"Kerm codes" protocol for such visual components, encoded as OSC codes then rendered in
+I’ve separately built a new desktop terminal app, Kerm, which adds support for a simple
+“Kerm codes” protocol for such visual components, encoded as OSC codes then rendered in
 the terminal. Because Kash supports these codes, as this develops you will get the
 visuals of a web app layered on the flexibility of a text-based terminal.
 
 ### Is Kash Mature?
 
-No. :) It's the result of a couple months of coding and experimentation, and it's very
-much in progress. Please help me make it better by sharing your ideas and feedback!
-It's easiest to DM me at [twitter.com/ojoshe](https://x.com/ojoshe).
+It’s the result of a couple months of coding and experimentation, and it’s still in
+progress and has rough edges.
+Please help me make it better by sharing your ideas and feedback!
+It’s easiest to DM me at [twitter.com/ojoshe](https://x.com/ojoshe).
 My contact info is at [github.com/jlevy](https://github.com/jlevy).
 
 [**Please follow or DM me**](https://x.com/ojoshe) for future updates or if you have

kash/docs/markdown/topics/a2_installation.md

@@ -4,7 +4,7 @@
 
 Kash offers a shell environment based on [xonsh](https://xon.sh/) augmented with a bunch
 of enhanced commands and customizations.
-If you've used a bash or Python shell before, it should be very intuitive.
+If you’ve used a bash or Python shell before, it should be very intuitive.
 
 Within the kash shell, you get a full environment with all actions and commands.
 You also get intelligent auto-complete, a built-in assistant to help you perform tasks,
@@ -13,7 +13,7 @@ and enhanced tab completion.
 The shell is an easy way to use Kash actions, simply calling them like other shell
 commands from the command line.
 
-But remember that's just one way to use actions; you can also use them directly in
+But remember that’s just one way to use actions; you can also use them directly in
 Python or from an MCP client.
 
 ### Current Kash Packages
@@ -23,7 +23,7 @@ However, some use cases require additional libraries, like video downloading too
 handling, etc.
 
 To keep kash dependencies more manageable, these additional utilities and actions are
-packaged additional "kits".
+packaged additional “kits”.
 
 The examples below use video transcription from YouTube as an example.
 To start with more full examples, I suggest starting with the `kash-media` kit.
@@ -38,7 +38,7 @@ These are for `kash-media` but you can use a `kash-shell` for a more basic setup
    Kash is easiest to use via [**uv**](https://docs.astral.sh/uv/), the new package
    manager for Python. `uv` replaces traditional use of `pyenv`, `pipx`, `poetry`, `pip`,
    etc. Installing `uv` also ensures you get a compatible version of Python.
-   See [uv's docs](https://docs.astral.sh/uv/getting-started/installation/) for other
+   See [uv’s docs](https://docs.astral.sh/uv/getting-started/installation/) for other
    installation methods and platforms.
    Usually you just want to run:
    ```shell
@@ -47,7 +47,7 @@ These are for `kash-media` but you can use a `kash-shell` for a more basic setup
 
 2. **Install additional command-line tools:**
 
-   In addition to Python, it's highly recommended to install a few other dependencies to
+   In addition to Python, it’s highly recommended to install a few other dependencies to
    make more tools and commands work.
    For macOS, you can again use brew:
 
@@ -104,7 +104,7 @@ These are for `kash-media` but you can use a `kash-shell` for a more basic setup
    ```
 
    These keys should go in the `.env` file in your current work directory or a parent or
-   your home directory (recommended if you'll be working in several directories, as with
+   your home directory (recommended if you’ll be working in several directories, as with
    a typical shell).
 
 5. **Run kash:**
@@ -144,14 +144,14 @@ If you add the `--proxy` arg, it will run an MCP stdio server but connect to the
 server you are running in the kash shell, by default at `localhost:4440`.
 
 Then if you run `start_mcp_server` from the shell, your client will connect to your
-shell, and you can actually use any "published" kash action as an MCP tool.
+shell, and you can actually use any “published” kash action as an MCP tool.
 
-Then you can for example ask your MCP client "can you transcribe this video?"
+Then you can for example ask your MCP client “can you transcribe this video?”
 and give it a URL, and it will be able to call the `transcribe` action as a tool.
 
 What is even better is that all the inputs and outputs are saved in the current kash
-workspace, just as if you'd been running these commands yourself in the shell.
-This way, you don't lose context or any work, and can seamlessly switch between an MCP
+workspace, just as if you’d been running these commands yourself in the shell.
+This way, you don’t lose context or any work, and can seamlessly switch between an MCP
 client like Cursor, the shell, and any other tools to edit the inputs or outputs of
 actions in your workspace directory.
 

kash/docs/markdown/topics/a3_getting_started.md

@@ -15,11 +15,11 @@ Type `help` for the full documentation.
 The simplest way to illustrate how to use kash is by example.
 You can go through the commands below a few at a time, trying each one.
 
-This is a "real" example that uses ffmpeg and a few other libraries.
-So to get it to work you must install not just the main shell but the kash "media kit"
+This is a “real” example that uses ffmpeg and a few other libraries.
+So to get it to work you must install not just the main shell but the kash “media kit”
 with extra dependencies.
 This is discussed in [the installation instructions](#installation-steps).
-If you don't have these already installed, you can add these tools:
+If you don’t have these already installed, you can add these tools:
 
 Then run `kash` to start.
 
@@ -170,8 +170,8 @@ All of these steps are just actions.
 
 ### Creating a New Workspace
 
-Although you don't always need one, a *workspace* is very helpful for any real work in
-kash. It's just a directory of files, plus a `.kash/` directory with various logs and
+Although you don’t always need one, a *workspace* is very helpful for any real work in
+kash. It’s just a directory of files, plus a `.kash/` directory with various logs and
 metadata.
 
 Note the `.kash/cache` directory contains all the downloaded videos and media you
@@ -192,7 +192,7 @@ By default, when you are not using the shell inside a workspace directory, or wh
 run kash the first time, it uses the default *global workspace*.
 
 Once you create a workspace, you can `cd` into that workspace and that will become the
-current workspace. (If you're familiar with how the `git` command-line works in
+current workspace. (If you’re familiar with how the `git` command-line works in
 conjunction with the `.git/` directory, this behavior is very similar.)
 
 To start a new workspace, run a command like
@@ -230,7 +230,7 @@ A few of the most important commands for managing files and work are these:
 
 - `workspace` shows or selects or creates a new workspace.
   Initially you work in the default global workspace (typically at `~/Kash/workspace`)
-  but for more real work you'll want to create a workspace, which is a directory to hold
+  but for more real work you’ll want to create a workspace, which is a directory to hold
   the files you are working with.
 
 - `select` shows or sets selections, which are the set of files the next command will
@@ -244,7 +244,7 @@ A few of the most important commands for managing files and work are these:
 
 - `logs` to see full logs (typically more detailed than what you see in the console).
 
-- `history` to see recent commands you've run.
+- `history` to see recent commands you’ve run.
 
 - `import_item` to add a resource such as a URL or a file to your local workspace.
 

kash/docs/markdown/topics/a4_elements.md

@@ -2,7 +2,7 @@
 
 ### What is Included?
 
-I've tried to build independently useful pieces that fit together in a simple way:
+I’ve tried to build independently useful pieces that fit together in a simple way:
 
 - The kash **action framework**:
 
@@ -75,9 +75,9 @@ I've tried to build independently useful pieces that fit together in a simple wa
     OSC 8 links
 
   - Sadly, we may have mind-boggling AI tools, but Terminals are still incredibly
-    archaic and don't support these features well (more on this below) but I have a new
+    archaic and don’t support these features well (more on this below) but I have a new
     terminal, Kerm, that shows these as tooltips and makes every command clickable
-    (please contact me if you'd like an early developer preview, as I'd love feedback)
+    (please contact me if you’d like an early developer preview, as I’d love feedback)
 
 ## Tools Used by Kash
 

kash/docs/markdown/topics/a5_tips_for_use_with_other_tools.md

@@ -17,14 +17,14 @@ I tried half a dozen different popular terminals on Mac
 [Hyper](https://hyper.is/)). Unfortunately, none offer really good support right out of
 the box, but I encourage you to try
 
-✨**Would you be willing to help test something new?** If you've made it this far and are
+✨**Would you be willing to help test something new?** If you’ve made it this far and are
 still reading, I have a request.
-So alongside kash, I've begun to build a new terminal app, **Kerm**, that has the
+So alongside kash, I’ve begun to build a new terminal app, **Kerm**, that has the
 features we would want in a modern command line, such as clickable links and commands,
 tooltips, and image support.
 Kash also takes advantage of this support by embedding OSC 8 links.
 It is *so* much nicer to use.
-I'd like feedback so please [message me](https://twitter.com/ojoshe) if you'd like to
+I’d like feedback so please [message me](https://twitter.com/ojoshe) if you’d like to
 try it out an early dev version!
 
 ### Choosing an Editor
@@ -34,7 +34,7 @@ Kash respects the `EDITOR` environment variable if you use the `edit` command.
 
 ### Using on macOS
 
-Kash calls `open` to open some files, so in general, it's convenient to make sure your
+Kash calls `open` to open some files, so in general, it’s convenient to make sure your
 preferred editor is set up for `.yml` and `.md` files.
 
 For convenience, a reminder on how to do this:
@@ -42,7 +42,7 @@ For convenience, a reminder on how to do this:
 - In Finder, pick a `.md` or `.yml` file and hit Cmd-I (or right-click and select Get
   Info).
 
-- Select the editor, such as Cursor or VSCode or Obsidian, and click the "Change All…"
+- Select the editor, such as Cursor or VSCode or Obsidian, and click the “Change All…”
   button to have it apply to all files with that extension.
 
 - Repeat with each file type.
@@ -61,23 +61,23 @@ out of the box to edit workspace files in Markdown, HTML, and YAML in kash works
 Kash uses Markdown files with YAML frontmatter, which is fully compatible with
 [Obsidian](https://obsidian.md/). Some notes:
 
-- In Obsidian's preferences, under Editor, turn on "Strict line breaks".
+- In Obsidian’s preferences, under Editor, turn on “Strict line breaks”.
 
-- This makes the line breaks in kash's normalized Markdown output work well in Obsidian.
+- This makes the line breaks in kash’s normalized Markdown output work well in Obsidian.
 
 - Some kash files also contain HTML in Markdown.
-  This works fine, but note that only the current line's HTML is shown in Obsidian.
+  This works fine, but note that only the current line’s HTML is shown in Obsidian.
 
 - Install the [Front Matter Title
   plugin](https://github.com/snezhig/obsidian-front-matter-title):
 
-  - Go to settings, enable community plugins, search for "Front Matter Title" and
+  - Go to settings, enable community plugins, search for “Front Matter Title” and
     install.
 
-  - Under "Installed Plugins," adjust the settings to enable "Replace shown title in
-    file explorer," "Replace shown title in graph," etc.
+  - Under “Installed Plugins,” adjust the settings to enable “Replace shown title in
+    file explorer,” “Replace shown title in graph,” etc.
 
-  - You probably want to keep the "Replace titles in header of leaves" off so you can
+  - You probably want to keep the “Replace titles in header of leaves” off so you can
     still see original filenames if needed.
 
   - Now titles are easy to read for all kash notes.