kash-shell 0.3.10__tar.gz → 0.3.12__tar.gz

{kash_shell-0.3.10 → kash_shell-0.3.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kash-shell
-Version: 0.3.10
+Version: 0.3.12
 Summary: The knowledge agent shell (core)
 Project-URL: Repository, https://github.com/jlevy/kash-shell
 Author-email: Joshua Levy <joshua@cal.berkeley.edu>
@@ -20,30 +20,30 @@ Requires-Dist: anyio>=4.8.0
 Requires-Dist: audioop-lts>=0.2.1; python_version >= '3.13'
 Requires-Dist: cachetools>=5.5.2
 Requires-Dist: chopdiff>=0.2.1
-Requires-Dist: clideps>=0.1.1
+Requires-Dist: clideps>=0.1.4
 Requires-Dist: colour>=0.1.5
 Requires-Dist: cssselect>=1.2.0
 Requires-Dist: deepgram-sdk>=3.10.1
 Requires-Dist: dunamai>=1.23.0
 Requires-Dist: fastapi>=0.115.11
-Requires-Dist: flowmark>=0.4.1
+Requires-Dist: flowmark>=0.4.6
 Requires-Dist: frontmatter-format>=0.2.1
 Requires-Dist: funlog>=0.2.0
 Requires-Dist: humanfriendly>=10.0
-Requires-Dist: inflect>=7.5.0
 Requires-Dist: inquirerpy>=0.3.4
 Requires-Dist: jinja2>=3.1.6
 Requires-Dist: justext>=3.0.2
 Requires-Dist: lazyasd>=0.1.4
 Requires-Dist: litellm>=1.63.11
-Requires-Dist: markdownify>=0.14.1
+Requires-Dist: markdownify>=0.13.1
 Requires-Dist: mcp-proxy>=0.5.0
 Requires-Dist: mcp>=1.6.0
 Requires-Dist: openai>=1.66.3
 Requires-Dist: pandas>=2.2.3
 Requires-Dist: patch-ng>=1.18.1
 Requires-Dist: pathspec>=0.12.1
-Requires-Dist: prettyfmt>=0.3.0
+Requires-Dist: pluralizer>=1.2.0
+Requires-Dist: prettyfmt>=0.3.1
 Requires-Dist: prompt-toolkit>=3.0.50
 Requires-Dist: pydantic>=2.10.6
 Requires-Dist: pydub>=0.25.1
@@ -59,7 +59,7 @@ Requires-Dist: rich>=14.0.0
 Requires-Dist: ripgrepy>=2.1.0
 Requires-Dist: send2trash>=1.8.3
 Requires-Dist: setproctitle>=1.3.5
-Requires-Dist: strif>=3.0.0-rc.1
+Requires-Dist: strif>=3.0.1
 Requires-Dist: tenacity>=9.0.0
 Requires-Dist: thefuzz>=0.22.1
 Requires-Dist: tiktoken>=0.9.0

{kash_shell-0.3.10 → kash_shell-0.3.12}/pyproject.toml

@@ -42,13 +42,13 @@ dependencies = [
     "pydantic>=2.10.6",
     "typing-extensions>=4.12.2",
     # My tools:
-    "strif>=3.0.0-rc.1",
+    "strif>=3.0.1",
     "funlog>=0.2.0",
-    "prettyfmt>=0.3.0",
-    "flowmark>=0.4.1",
+    "prettyfmt>=0.3.1",
+    "flowmark>=0.4.6",
     "frontmatter-format>=0.2.1",
     "chopdiff>=0.2.1",
-    "clideps>=0.1.1",
+    "clideps>=0.1.4",
     # Shell and file essentials:
     # python-magic is most current and works with libmagic on macOS and Linux.
     # on Windows, python-magic-bin seems like the best option.
@@ -71,7 +71,6 @@ dependencies = [
     "tldr>=3.3.0",
     "jinja2>=3.1.6",
     "pygments>=2.19.1",
-    "inflect>=7.5.0",
     "tenacity>=9.0.0",
     "lazyasd>=0.1.4",
     "pathspec>=0.12.1",
@@ -83,9 +82,10 @@ dependencies = [
     "litellm>=1.63.11",
     # Basic text handling and web scraping:
     "readabilipy>=0.3.0",
-    "markdownify>=0.14.1",
+    "markdownify>=0.13.1",
     "justext>=3.0.2",
     "cssselect>=1.2.0",
+    "pluralizer>=1.2.0",
     # Minimal media handling:
     "pydub>=0.25.1",
     # audioop-lts is a backport of audioop for Python 3.13 and later needed for pydub.
@@ -105,6 +105,7 @@ dependencies = [
 [dependency-groups]
 dev = [
     "pytest>=8.3.5",
+    "pytest-sugar>=1.0.0",
     "ruff>=0.11.0",
     "codespell>=2.4.1",
     "rich>=14.0.0",

{kash_shell-0.3.10 → kash_shell-0.3.12}/src/kash/actions/core/format_markdown_template.py

@@ -4,7 +4,7 @@ from pathlib import Path
 from kash.config.logger import get_logger
 from kash.exec import kash_action
 from kash.exec.preconditions import is_markdown
-from kash.model import ONE_OR_MORE_ARGS, ActionInput, ActionResult, ItemType, Param
+from kash.model import ONE_OR_MORE_ARGS, ActionInput, ActionResult, Param
 from kash.utils.common.type_utils import not_none
 from kash.utils.errors import InvalidInput
 
@@ -84,9 +84,6 @@ def format_markdown_template(
     # Format the body using the mapped items.
     body = template.format(**item_map)
 
-    result_item = items[0].derived_copy(
-        type=ItemType.doc,
-        body=body,
-    )
+    result_item = items[0].derived_copy(body=body)
 
     return ActionResult([result_item])

{kash_shell-0.3.10 → kash_shell-0.3.12}/src/kash/actions/core/markdownify.py

@@ -1,7 +1,7 @@
 from kash.config.logger import get_logger
 from kash.exec import kash_action
 from kash.exec.preconditions import has_html_body, is_url_item
-from kash.model import Format, Item, ItemType
+from kash.model import Format, Item
 from kash.model.params_model import common_params
 from kash.web_content.file_cache_utils import get_url_html
 from kash.web_content.web_extract_readabilipy import extract_text_readabilipy
@@ -26,7 +26,5 @@ def markdownify(item: Item, refetch: bool = False) -> Item:
     page_data = extract_text_readabilipy(url, html_content)
     markdown_content = markdownify_convert(page_data.clean_html)
 
-    output_item = item.derived_copy(
-        type=ItemType.doc, format=Format.markdown, body=markdown_content
-    )
+    output_item = item.derived_copy(format=Format.markdown, body=markdown_content)
     return output_item

{kash_shell-0.3.10 → kash_shell-0.3.12}/src/kash/actions/core/readability.py

@@ -1,7 +1,7 @@
 from kash.config.logger import get_logger
 from kash.exec import kash_action
 from kash.exec.preconditions import has_html_body, is_url_item
-from kash.model import Format, Item, ItemType
+from kash.model import Format, Item
 from kash.model.params_model import common_params
 from kash.web_content.file_cache_utils import get_url_html
 from kash.web_content.web_extract_readabilipy import extract_text_readabilipy
@@ -23,8 +23,6 @@ def readability(item: Item, refetch: bool = False) -> Item:
     url, html_content = get_url_html(item, expiration_sec=expiration_sec)
     page_data = extract_text_readabilipy(url, html_content)
 
-    output_item = item.derived_copy(
-        type=ItemType.doc, format=Format.html, body=page_data.clean_html
-    )
+    output_item = item.derived_copy(format=Format.html, body=page_data.clean_html)
 
     return output_item

kash_shell-0.3.12/src/kash/actions/core/render_as_html.py

@@ -0,0 +1,37 @@
+from kash.actions.core.tabbed_webpage_config import tabbed_webpage_config
+from kash.actions.core.tabbed_webpage_generate import tabbed_webpage_generate
+from kash.exec import kash_action
+from kash.exec.preconditions import has_full_html_page_body, has_html_body, has_simple_text_body
+from kash.exec_model.args_model import ONE_OR_MORE_ARGS
+from kash.model import ActionInput, ActionResult, Param
+from kash.model.items_model import ItemType
+from kash.utils.file_utils.file_formats_model import Format
+from kash.web_gen.simple_webpage import simple_webpage_render
+
+
+@kash_action(
+    expected_args=ONE_OR_MORE_ARGS,
+    precondition=(has_html_body | has_simple_text_body) & ~has_full_html_page_body,
+    params=(Param("add_title", "Add a title to the page body.", type=bool),),
+)
+def render_as_html(input: ActionInput, add_title: bool = False) -> ActionResult:
+    """
+    Convert text, Markdown, or HTML to pretty, formatted HTML using a clean
+    and simple page template. Supports GFM-flavored Markdown tables and footnotes.
+
+    If it's a single input, the output is a simple HTML page.
+    If it's multiple inputs, the output is a tabbed HTML page.
+
+    This adds a header, footer, etc. so should be used on a plain document or HTML basic
+    page, not a full HTML page with header and body already present.
+    """
+    if len(input.items) == 1:
+        input_item = input.items[0]
+        html_body = simple_webpage_render(input_item, add_title_h1=add_title)
+        result_item = input_item.derived_copy(
+            type=ItemType.export, format=Format.html, body=html_body
+        )
+        return ActionResult([result_item])
+    else:
+        config_result = tabbed_webpage_config(input)
+        return tabbed_webpage_generate(ActionInput(items=config_result.items), add_title=add_title)

{kash_shell-0.3.10 → kash_shell-0.3.12}/src/kash/actions/core/show_webpage.py

@@ -1,27 +1,22 @@
-from kash.actions.core.webpage_config import webpage_config
-from kash.actions.core.webpage_generate import webpage_generate
+from kash.actions.core.render_as_html import render_as_html
 from kash.commands.base.show_command import show
-from kash.config.logger import get_logger
 from kash.exec import kash_action
-from kash.exec.preconditions import has_text_body, is_html
+from kash.exec.preconditions import has_full_html_page_body, has_html_body, has_simple_text_body
+from kash.exec_model.args_model import ONE_OR_MORE_ARGS
 from kash.exec_model.commands_model import Command
 from kash.exec_model.shell_model import ShellResult
 from kash.model import ActionInput, ActionResult
 
-log = get_logger(__name__)
-
 
 @kash_action(
-    precondition=is_html | has_text_body,
+    expected_args=ONE_OR_MORE_ARGS,
+    precondition=(has_html_body | has_simple_text_body) & ~has_full_html_page_body,
 )
 def show_webpage(input: ActionInput) -> ActionResult:
     """
     Show text, Markdown, or HTML as a nicely formatted webpage.
     """
-    config_result = webpage_config(input)
-
-    log.message("Configured web page: %s", config_result)
-    result = webpage_generate(ActionInput(items=config_result.items))
+    result = render_as_html(input)
 
     # Automatically show the result.
     result.shell_result = ShellResult(display_command=Command.assemble(show))

{kash_shell-0.3.10 → kash_shell-0.3.12}/src/kash/actions/core/strip_html.py

@@ -1,14 +1,14 @@
 from kash.config.logger import get_logger
 from kash.exec import kash_action
-from kash.exec.preconditions import has_html_body, has_text_body
-from kash.model import Format, Item, ItemType
+from kash.exec.preconditions import has_html_body, has_simple_text_body
+from kash.model import Format, Item
 from kash.utils.common.format_utils import html_to_plaintext
 from kash.utils.errors import InvalidInput
 
 log = get_logger(__name__)
 
 
-@kash_action(precondition=has_html_body | has_text_body)
+@kash_action(precondition=has_html_body | has_simple_text_body)
 def strip_html(item: Item) -> Item:
     """
     Strip HTML tags from HTML or Markdown. This is a simple filter, simply searching
@@ -19,10 +19,6 @@ def strip_html(item: Item) -> Item:
         raise InvalidInput("Item must have a body")
 
     clean_body = html_to_plaintext(item.body)
-    output_item = item.derived_copy(
-        type=ItemType.doc,
-        format=Format.markdown,
-        body=clean_body,
-    )
+    output_item = item.derived_copy(format=Format.markdown, body=clean_body)
 
     return output_item

kash_shell-0.3.10/src/kash/actions/core/webpage_config.py → kash_shell-0.3.12/src/kash/actions/core/tabbed_webpage_config.py

@@ -1,5 +1,6 @@
 from kash.config.logger import get_logger
 from kash.exec import kash_action
+from kash.exec_model.args_model import ONE_OR_MORE_ARGS
 from kash.model import ActionInput, ActionResult, Param
 from kash.utils.errors import InvalidInput
 from kash.web_gen import tabbed_webpage
@@ -8,15 +9,16 @@ log = get_logger(__name__)
 
 
 @kash_action(
+    expected_args=ONE_OR_MORE_ARGS,
     params=(
         Param(
             name="clean_headings",
             type=bool,
             description="Use an LLM to clean up headings.",
         ),
-    )
+    ),
 )
-def webpage_config(input: ActionInput, clean_headings: bool = False) -> ActionResult:
+def tabbed_webpage_config(input: ActionInput, clean_headings: bool = False) -> ActionResult:
     """
     Set up a web page config with optional tabs for each page of content. Uses first item as the page title.
     """
@@ -24,6 +26,6 @@ def webpage_config(input: ActionInput, clean_headings: bool = False) -> ActionRe
         if not item.body:
             raise InvalidInput(f"Item must have a body: {item}")
 
-    config_item = tabbed_webpage.webpage_config(input.items, clean_headings)
+    config_item = tabbed_webpage.tabbed_webpage_config(input.items, clean_headings)
 
     return ActionResult([config_item])

kash_shell-0.3.10/src/kash/actions/core/webpage_generate.py → kash_shell-0.3.12/src/kash/actions/core/tabbed_webpage_generate.py

@@ -1,7 +1,7 @@
 from kash.config.logger import get_logger
 from kash.exec import kash_action
 from kash.exec.preconditions import is_config
-from kash.model import ONE_ARG, ActionInput, ActionResult, FileExt, Format, Item, ItemType
+from kash.model import ONE_ARG, ActionInput, ActionResult, FileExt, Format, Item, ItemType, Param
 from kash.web_gen import tabbed_webpage
 
 log = get_logger(__name__)
@@ -10,13 +10,14 @@ log = get_logger(__name__)
 @kash_action(
     expected_args=ONE_ARG,
     precondition=is_config,
+    params=(Param("add_title", "Add a title to the page body.", type=bool),),
 )
-def webpage_generate(input: ActionInput) -> ActionResult:
+def tabbed_webpage_generate(input: ActionInput, add_title: bool = False) -> ActionResult:
     """
-    Generate a web page from a configured web page item.
+    Generate a tabbed web page from a config item for the tabbed template.
     """
     config_item = input.items[0]
-    html = tabbed_webpage.webpage_generate(config_item)
+    html = tabbed_webpage.tabbed_webpage_generate(config_item, add_title_h1=add_title)
 
     webpage_item = Item(
         title=config_item.title,

{kash_shell-0.3.10 → kash_shell-0.3.12}/src/kash/commands/base/basic_file_commands.py

@@ -2,7 +2,7 @@ import os
 
 from frontmatter_format import fmf_read_raw, fmf_strip_frontmatter
 from prettyfmt import fmt_lines
-from strif import copyfile_atomic
+from strif import atomic_output_file, copyfile_atomic
 
 from kash.config.logger import get_logger
 from kash.config.text_styles import STYLE_EMPH
@@ -28,10 +28,10 @@ log = get_logger(__name__)
 
 
 @kash_command
-def cbcopy(path: str | None = None, raw: bool = False) -> None:
+def clipboard_copy(path: str | None = None, raw: bool = False) -> None:
     """
     Copy the contents of a file (or the first file in the selection) to the OS-native
-    clipboard.
+    clipboard. Similar to `pbcopy` on macOS.
 
     :param raw: Copy the full exact contents of the file. Otherwise frontmatter is omitted.
     """
@@ -39,6 +39,8 @@ def cbcopy(path: str | None = None, raw: bool = False) -> None:
     import pyperclip
 
     input_paths = assemble_path_args(path)
+    if not input_paths:
+        raise InvalidInput("No path provided")
     input_path = input_paths[0]
 
     format = detect_file_format(input_path)
@@ -69,6 +71,22 @@ def cbcopy(path: str | None = None, raw: bool = False) -> None:
         )
 
 
+@kash_command
+def clipboard_paste(path: str = "untitled_paste.txt") -> None:
+    """
+    Paste the contents of the OS-native clipboard into a new file.
+    """
+    # TODO: Get this to work for images!
+    # And can we convert rich text to Markdown?
+    import pyperclip
+
+    contents = pyperclip.paste()
+    with atomic_output_file(path, backup_suffix=".{timestamp}.bak") as f:
+        f.write_text(contents)
+
+    print_status("Pasted clipboard contents to:\n%s", fmt_lines([fmt_loc(path)]))
+
+
 @kash_command
 def edit(path: str | None = None, all: bool = False) -> None:
     """

{kash_shell-0.3.10 → kash_shell-0.3.12}/src/kash/commands/base/files_command.py

@@ -75,6 +75,10 @@ def _print_listing_tallies(
         cprint("(use --no_max to remove cutoff)", style=STYLE_HINT)
 
 
+DEFAULT_MAX_PER_GROUP = 50
+"""Default maximum number of files to display per group."""
+
+
 @kash_command
 def files(
     *paths: str,
@@ -108,9 +112,11 @@ def files(
     and grouping.
 
     :param overview: Recurse a couple levels and show files, but not too many.
-        Same as `--groupby=parent --depth=2 --max_per_group=10 --omit_dirs`.
+        Same as `--groupby=parent --depth=2 --max_per_group=100 --omit_dirs`
+        except also scales down `max_per_group` to 25 or 50 if there are many files.
     :param recent: Only shows the most recently modified files in each directory.
-        Same as `--sort=modified --reverse --groupby=parent --max_per_group=10`.
+        Same as `--sort=modified --reverse --groupby=parent --max_per_group=100`
+        except also scales down `max_per_group` to 25 or 50 if there are many files.
     :param recursive: List all files recursively. Same as `--depth=-1`.
     :param flat: Show files in a flat list, rather than grouped by parent directory.
         Same as `--groupby=flat`.
@@ -179,16 +185,17 @@ def files(
         # Within workspaces, we show more files by default since they are always in
         # subdirectories.
         overview = True  # Handled next.
+    cap_per_group = False
     if overview:
-        max_per_group = 10 if max_per_group <= 0 else max_per_group
         groupby = GroupByOption.parent if groupby is None else groupby
         depth = 2 if depth is None else depth
+        cap_per_group = True
         omit_dirs = True
     if recent:
-        max_per_group = 10 if max_per_group <= 0 else max_per_group
         groupby = GroupByOption.parent if groupby is None else groupby
         depth = 2 if depth is None else depth
         sort = SortOption.modified if sort is None else sort
+        cap_per_group = True
         reverse = True
     if flat:
         groupby = GroupByOption.flat
@@ -291,6 +298,18 @@ def files(
 
         return ShellResult(show_selection=True)
 
+    # Unless max_per_group is explicit, use heuristics to limit per group if
+    # there are lots of groups and lots of files per group.
+    # Default is max 100 per group but if we have 4 * 100 items, cut to 25.
+    # If we have 2 * 100 items, cut to 50.
+    final_max_pg = DEFAULT_MAX_PER_GROUP if cap_per_group else max_per_group
+    max_pg_explicit = max_per_group > 0
+    if not max_pg_explicit:
+        group_lens = [len(group_df) for group_df in grouped]
+        for ratio in [2, 4]:
+            if sum(group_lens) > ratio * DEFAULT_MAX_PER_GROUP:
+                final_max_pg = int(DEFAULT_MAX_PER_GROUP / ratio)
+
     total_displayed = 0
     total_displayed_size = 0
     now = datetime.now(UTC)
@@ -312,8 +331,8 @@ def files(
                         text_wrap=Wrap.NONE,
                     )
 
-                if max_per_group > 0:
-                    display_df = group_df.head(max_per_group)
+                if final_max_pg > 0:
+                    display_df = group_df.head(final_max_pg)
                 else:
                     display_df = group_df
 
@@ -378,9 +397,9 @@ def files(
                     total_displayed_size += row.size
 
                 # Indicate if items are omitted.
-                if groupby and max_per_group > 0 and len(group_df) > max_per_group:
+                if groupby and final_max_pg > 0 and len(group_df) > final_max_pg:
                     cprint(
-                        f"{indent}… and {len(group_df) - max_per_group} more files",
+                        f"{indent}… and {len(group_df) - final_max_pg} more files",
                         style=COLOR_EXTRA,
                         text_wrap=Wrap.NONE,
                     )
@@ -388,9 +407,9 @@ def files(
                 if group_name:
                     PrintHooks.spacer()
 
-            if not groupby and max_per_group > 0 and items_matching > max_per_group:
+            if not groupby and final_max_pg > 0 and items_matching > final_max_pg:
                 cprint(
-                    f"{indent}… and {items_matching - max_per_group} more files",
+                    f"{indent}… and {items_matching - final_max_pg} more files",
                     style=COLOR_EXTRA,
                     text_wrap=Wrap.NONE,
                 )

{kash_shell-0.3.10 → kash_shell-0.3.12}/src/kash/commands/extras/parse_uv_lock.py

@@ -1,8 +1,10 @@
+from __future__ import annotations
+
 import subprocess
 import tomllib
 from pathlib import Path
+from typing import TYPE_CHECKING
 
-import pandas as pd
 from packaging.tags import Tag, sys_tags
 from packaging.utils import parse_wheel_filename
 from prettyfmt import fmt_size_dual
@@ -13,6 +15,9 @@ from kash.config.text_styles import COLOR_STATUS
 from kash.exec import kash_command
 from kash.shell.output.shell_output import cprint
 
+if TYPE_CHECKING:
+    from pandas import DataFrame
+
 log = get_logger(__name__)
 
 
@@ -49,13 +54,15 @@ def get_platform() -> str:
     return next(sys_tags()).platform
 
 
-def parse_uv_lock(lock_path: Path) -> pd.DataFrame:
+def parse_uv_lock(lock_path: Path) -> DataFrame:
     """
     Return one row per package from a uv.lock file, selecting the best
     matching wheel for the current interpreter or falling back to the sdist.
 
     Columns: name, version, registry, file_type, url, hash, size, filename.
     """
+    from pandas import DataFrame
+
     with open(lock_path, "rb") as f:
         data = tomllib.load(f)
 
@@ -88,7 +95,7 @@ def parse_uv_lock(lock_path: Path) -> pd.DataFrame:
             }
         )
 
-    return pd.DataFrame(rows)
+    return DataFrame(rows)
 
 
 def uv_runtime_packages(
@@ -141,6 +148,8 @@ def uv_dep_info(
     By default, filters to show only 'main' dependencies from pyproject.toml.
     Helpful for looking at sizes of dependencies.
     """
+    import pandas as pd
+
     uv_lock_path = Path(uv_lock)
     pyproject_path = Path(pyproject)
 

{kash_shell-0.3.10 → kash_shell-0.3.12}/src/kash/commands/workspace/selection_commands.py

@@ -10,8 +10,8 @@ from kash.exec_model.shell_model import ShellResult
 from kash.model.paths_model import StorePath
 from kash.shell.ui.shell_results import shell_print_selection_history
 from kash.utils.common.format_utils import fmt_loc
+from kash.utils.common.inflection import plural
 from kash.utils.errors import InvalidInput
-from kash.utils.lang_utils.inflection import plural
 from kash.workspaces import Selection, current_ws
 
 log = get_logger(__name__)

{kash_shell-0.3.10 → kash_shell-0.3.12}/src/kash/commands/workspace/workspace_commands.py

@@ -51,6 +51,7 @@ from kash.shell.output.shell_output import (
 )
 from kash.shell.utils.native_utils import tail_file
 from kash.utils.common.format_utils import fmt_loc
+from kash.utils.common.inflection import plural
 from kash.utils.common.obj_replace import remove_values
 from kash.utils.common.parse_key_vals import parse_key_value
 from kash.utils.common.type_utils import not_none
@@ -58,7 +59,6 @@ from kash.utils.common.url import Url, is_url
 from kash.utils.errors import InvalidInput
 from kash.utils.file_formats.chat_format import tail_chat_history
 from kash.utils.file_utils.dir_info import is_nonempty_dir
-from kash.utils.lang_utils.inflection import plural
 from kash.web_content.file_cache_utils import cache_file
 from kash.workspaces import (
     current_ws,
@@ -285,7 +285,7 @@ def init_workspace(path: str | None = None) -> None:
 @kash_command
 def workspace(workspace_name: str | None = None) -> None:
     """
-    If no args are given, change directory to the current workspace.
+    If no args are given, show current workspace info.
     If a workspace name is given, change to that workspace, creating it if it doesn't exist.
     """
     if workspace_name:
@@ -302,7 +302,6 @@ def workspace(workspace_name: str | None = None) -> None:
         ws.log_workspace_info()
     else:
         ws = current_ws(silent=True)
-        os.chdir(ws.base_dir)
         ws.log_workspace_info()
 
 

{kash_shell-0.3.10 → kash_shell-0.3.12}/src/kash/config/colors.py

@@ -136,8 +136,8 @@ web_light_translucent = SimpleNamespace(
     bg=hsl_to_hex("hsla(44, 6%, 100%, 0.75)"),
     bg_solid=hsl_to_hex("hsla(44, 6%, 100%, 1)"),
     bg_header=hsl_to_hex("hsla(188, 42%, 70%, 0.2)"),
-    bg_alt=hsl_to_hex("hsla(44, 28%, 90%, 0.3)"),
-    bg_alt_solid=hsl_to_hex("hsla(44, 28%, 97%, 1)"),
+    bg_alt=hsl_to_hex("hsla(39, 24%, 90%, 0.3)"),
+    bg_alt_solid=hsl_to_hex("hsla(39, 24%, 97%, 1)"),
     text=hsl_to_hex("hsl(188, 39%, 11%)"),
     border=hsl_to_hex("hsl(188, 8%, 50%)"),
     border_hint=hsl_to_hex("hsla(188, 8%, 72%, 0.7)"),

kash_shell-0.3.12/src/kash/config/env_settings.py

@@ -0,0 +1,32 @@
+from clideps.env_vars.env_enum import EnvEnum
+
+
+class KashEnv(EnvEnum):
+    """
+    Environment variable settings for kash. None are required, but these may be
+    used to override default values.
+    """
+
+    KASH_LOG_LEVEL = "KASH_LOG_LEVEL"
+    """The log level for console-based logging."""
+
+    KASH_WS_ROOT = "KASH_WS_ROOT"
+    """The root directory for kash workspaces."""
+
+    KASH_GLOBAL_WS = "KASH_GLOBAL_WS"
+    """The global workspace directory."""
+
+    KASH_SYSTEM_LOGS_DIR = "KASH_SYSTEM_LOGS_DIR"
+    """The directory for system logs."""
+
+    KASH_SYSTEM_CACHE_DIR = "KASH_SYSTEM_CACHE_DIR"
+    """The directory for system cache (caches separate from workspace caches)."""
+
+    KASH_MCP_WS = "KASH_MCP_WS"
+    """The directory for the workspace for MCP servers."""
+
+    KASH_SHOW_TRACEBACK = "KASH_SHOW_TRACEBACK"
+    """Whether to show tracebacks on actions and commands in the shell."""
+
+    KASH_USER_AGENT = "KASH_USER_AGENT"
+    """The user agent to use for HTTP requests."""