Metadata-Version: 2.4
Name: zephyr-zecode
Version: 0.4.5
Summary: PowerShell-native ZeCode terminal client for Zephyr
Author: Zephyr Project
License-Expression: LicenseRef-Proprietary
Keywords: zecode,zephyr,coding-agent,terminal
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: mcp<2,>=1.27
Requires-Dist: httpx<1,>=0.27
Requires-Dist: arabic-reshaper<4,>=3
Requires-Dist: python-bidi<1,>=0.6
Requires-Dist: rich<15,>=13.7
Provides-Extra: classic
Requires-Dist: textual<7,>=0.85; extra == "classic"

# ZeCode 0.4.5

ZeCode is the PowerShell-native terminal client for Zephyr. It provides one
chronological conversation with inline tool activity, verified file delivery,
on-demand terminal menus, and secure Zephyr Gateway v2 device pairing.

Version `0.4.5` uses native terminal input and Rich output, without importing
Textual or using CSS in the default launch path. It retains normal terminal
scrollback and requires Zephyr `1.40.8` for session-free home startup.

0.4.5 fixes live group-event filtering, pending-session recovery and the PgUp/Esc screen wipe. Home does not create or attach to a session. Choose Resume explicitly or save automatic resume.

## Terminal experience

- Top-left native terminal home with model, workspace, mode, and effort.
- One chronological transcript for assistant text and real tool activity.
- Stable `File`, `Shell`, `Tests`, `Web Search`, `MCP`, and `Delivery` rows.
- Left-aligned multiline input with temporary menus; full-screen history and source viewers preserve the primary screen.
- Slash command search, model/theme/mode pickers, and F2 settings.
- Failed runs release their client lock immediately and do not duplicate chat.

0.4.3 adds batched Windows input, guarded unmarked paste, direct clipboard paste
with F4 on Windows, and collapsible long drafts (500 characters or six lines).
F6 toggles full text. Explicit paste waits for Enter. Unmarked input bursts use
F8 to submit; their Enter characters remain newlines. No backend or model changes.

0.4.2 added an explicit startup choice (new/resume/select session), optional
automatic resume, incremental row drawing with a single flush per update,
and role-labelled, wrapped conversation history. PgUp reads the current
conversation while preserving the draft; arriving output waits until Esc/End.
PageDown stops at the final full page, including after window resizing.
`/tools` opens coding tools first; media and other integrations live in
More tools. Browsing these categories does not alter runtime permissions.

## Install on Windows

Install Python 3.11 or newer, extract the complete release ZIP, then run in
PowerShell from that folder:

```powershell
Set-ExecutionPolicy -Scope Process Bypass
.\UPDATE_ZECODE_WINDOWS.ps1
zecode --version
```

Start ZeCode:

```powershell
zecode login
zecode doctor
zecode
```

The script verifies and installs the bundled wheel via pipx, in the same
PowerShell window. It prioritizes the pipx executable in the current and saved
user PATH. Internet is needed for pipx and any missing dependencies.

This ZIP is a local owner release, not confirmation of a PyPI publication.
The following command continues to update from the configured package index;
use the bundled script to install this exact release:

```powershell
zecode --update
```

The installed distribution is named `zephyr-zecode`; the terminal command is
always `zecode`.

## Native controls

Enter sends ordinary drafts; F8 sends guarded unmarked pastes. F4 on Windows
reads the clipboard as one paste, without relying on the host's Ctrl+V binding.
F6 expands/collapses long pasted drafts. Arrow and deletion keys reveal the
text before editing. Short pastes remain inline. A compact summary is only a
display representation; the full draft is sent. Shift+Enter (Windows) or
Alt+Enter inserts a newline. Ctrl+V on
Windows and bracketed paste insert multiline text as a single draft. `/` opens
suggestions, F2 settings, Ctrl+P commands, and Ctrl+L sessions. Tab cycles mode;
Esc stops an active run. Ctrl+Q exits. `/keyboard` lists all native shortcuts.

`/files` searches paths and previews/downloads files; `/diff` previews patches
and confirms accept/reject of all pending changes. `/mcp`, `/permissions`,
`/agents` and `/tools` use existing server controls. `/allow`, `/always` and
`/deny` resolve pending approvals.

Syntax themes color previews; terminal font and background remain terminal
settings. Native shortcuts are fixed in this release; previous Textual key
remappings do not apply. Historical Textual source remains for compatibility
tests with the optional `classic` dependency, and is not the default UI.
Arabic rendering can be selected in Display preferences.
