aichs

aichs is a minimal visual harness for agentic coding. Adapt it to your workflows, not the other way around.

Open a repository, chat with a model, and let the agent work with your code through approved tools, git context, file references, skills, and extensions. aichs treats the agent as something you can shape: prompts, models, UI behavior, workflow defaults, skills, extensions, tools, hooks, badges, and panels are all meant to be customized.

Python 3.11+ Tests

Status

aichs is early software. It is intended for developers who are comfortable running a local app that can read a workspace and, with approval, edit files or run shell commands.

Why aichs exists

Most coding agents give you a workflow. aichs gives you a workbench. It is for developers who want to tune the prompts, tools, context, approvals, memory, and UI around how they already work.

Install From PyPI

Install the published command with pipx:

pipx install aichs

Start it from a repository:

cd /path/to/your/repo
aichs

Or pass the workspace explicitly:

aichs /path/to/your/repo

Run

By default, aichs honors the directory it was started from. Use aichs --last-workspace only when you want to reopen the previously saved workspace.

Conversation history is stored in user data, not in your repository. Each workspace gets a stable entry in AICHS_HOME/workspaces.json (default ~/.aichs/workspaces.json) and its chats are saved under AICHS_HOME/<workspace_id>/conversations/.

API keys can be configured in Settings -> Models or through environment variables. Requires Python 3.11+.

What It Does

Open a workspace folder, pick a model, and work in one window:

  • Agentic coding: ask the agent to inspect files, explain code, search the repo, make edits, and run approved shell commands
  • Approval-gated tools: read, edit, search, git context, shell commands, and extension tools with workspace-scoped paths
  • Coding workspace: file tree, syntax-highlighted tabs, git status, diffs, file references, and conversation history
  • Context management: usage view, auto-compaction, compacted summaries, and project memory for long sessions
  • Customization: configurable prompts and workflow defaults, slash-command skills, command palette, project/user extensions, custom tools, hooks, badges, and panels
  • Conversation flow: streaming Markdown, vision-capable models, file mentions, edit/resend, queued messages, pinned chats, search, and export

Shell commands and extensions run as the current user; only enable extensions you trust.

Contributing

Contributor setup, source installs, tests, packaging, and release notes live in CONTRIBUTING.md.

Documentation

Topic
Configuration docs/configuration.md
Organization governance docs/organization-governance.md
Custom model providers docs/custom-models.md
Extensions and custom tools docs/extensions.md
Slash-command skills docs/skills.md
Compaction docs/compact.md
Project memory docs/project-memory.md
Project run recipes docs/recipes.md
Performance north star docs/performance-north-star.md
YUK user kits docs/yuk.md

FAQ

What does aichs stand for?

It is a play on Hebrew "ichs" (איכס), from Arabic إخسا, roughly "yuck" or "ew." The name is a little cursed on purpose.

Why use aichs when Cursor, Claude Code, Codex, and other agent tools exist?

You may not need it. Those tools are wonderful. aichs is for when you want a small, local, hackable agentic coding workspace that is shaped around your own habits.

Is aichs trying to replace my IDE?

No. It is a companion workbench: one window for the agent conversation, repo context, files, diffs, approvals, custom prompts, and extension tools.

Can I contribute something?

Very much. Small fixes, weird ideas, extensions, docs, and sharp opinions are all welcome. See CONTRIBUTING.md.

Does the S feel forced?

Yes. It is.

License

MIT License. See LICENSE.

Project links

Data verified by PyPI on Sep 8, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.5.6)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for donmyrmi from gravatar.com donmyrmi

Credits

Author: Nadav Yo

GitHub Statistics

Data verified by PyPI on Sep 8, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Tags

ai agent coding desktop pyqt

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aichs-0.5.5.tar.gz (873.8 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

aichs-0.5.5-py3-none-win_amd64.whl (1.1 MB view details)

Uploaded Python 3Windows x86-64

aichs-0.5.5-py3-none-manylinux_2_28_x86_64.whl (9.1 MB view details)

Uploaded Python 3manylinux: glibc 2.28+ x86-64

aichs-0.5.5-py3-none-macosx_11_0_arm64.whl (3.2 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

File details

Details for the file aichs-0.5.5.tar.gz.

File metadata

  • Download URL: aichs-0.5.5.tar.gz
  • Upload date:
  • Size: 873.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for aichs-0.5.5.tar.gz
Algorithm Hash digest
SHA256 265ed23a44390c95281cd367326e108aa5e0c47534bb316934af9c3487f24fd5
MD5 23b2e512aa9075a77c2c6b4bbcd5a7a7
BLAKE2b-256 df392edb31d0626d821dc03191365f1a5d617277fcafd3d226d9c9f1609c2222

See more details on using hashes here.

Provenance

The following attestation bundles were made for aichs-0.5.5.tar.gz:

Publisher: publish.yml on nadav-yo/aichs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aichs-0.5.5-py3-none-win_amd64.whl.

File metadata

  • Download URL: aichs-0.5.5-py3-none-win_amd64.whl
  • Upload date:
  • Size: 1.1 MB
  • Tags: Python 3, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for aichs-0.5.5-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 5f0f5f76ca379a9a79d06179384bb1bbd76dc0b8381c13b59975aed250a03778
MD5 e97b3067f387a918f8fc97d484bae14b
BLAKE2b-256 72f0fa50a40c0542a75be4bf5fd9b160ff5fbdf185c730dd8cce00158483ab0a

See more details on using hashes here.

Provenance

The following attestation bundles were made for aichs-0.5.5-py3-none-win_amd64.whl:

Publisher: publish.yml on nadav-yo/aichs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aichs-0.5.5-py3-none-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for aichs-0.5.5-py3-none-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 3493bc7f67ce0bfdf40e26ffc32c94f0cda56fc6646346b085acd2f14cb91c0b
MD5 75e08c007b4af10e774f58cc529ac122
BLAKE2b-256 e1ff0ce132d51a929ed992deb3e7a960086db2c0dd993826be624f7e17485152

See more details on using hashes here.

Provenance

The following attestation bundles were made for aichs-0.5.5-py3-none-manylinux_2_28_x86_64.whl:

Publisher: publish.yml on nadav-yo/aichs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aichs-0.5.5-py3-none-macosx_11_0_arm64.whl.

File metadata

  • Download URL: aichs-0.5.5-py3-none-macosx_11_0_arm64.whl
  • Upload date:
  • Size: 3.2 MB
  • Tags: Python 3, macOS 11.0+ ARM64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for aichs-0.5.5-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 fbb0f96c1bfb8a697b1def4723173c7dc2bba7d2cc7c85d37ac122862dc3e00c
MD5 4a3891752fb19fecf9094e9b98d9542d
BLAKE2b-256 8e81df60b67ce5de8769bfeba96f4405c89c8c54707f964f62adf8c1fc36265d

See more details on using hashes here.

Provenance

The following attestation bundles were made for aichs-0.5.5-py3-none-macosx_11_0_arm64.whl:

Publisher: publish.yml on nadav-yo/aichs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.5.6

4 files

This release

0.5.5 This release

4 files

0.5.4

4 files

0.5.3

4 files

0.5.2

4 files

0.5.1

4 files

0.5.0

4 files

0.4.10

4 files

0.4.9

4 files

0.4.5

2 files

0.4.4

2 files

0.4.3

2 files

0.4.2

2 files

0.4.1

2 files

0.4.0

2 files

0.3.2

2 files

0.3.1

2 files

0.3.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page