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.
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.
Metadata
Release files for aichs 0.5.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| aichs-0.5.6.tar.gz | 874.8 kB | With provenance | Details for aichs-0.5.6.tar.gz |
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| aichs-0.5.6-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details for aichs-0.5.6-py3-none-win_amd64.whl |
| aichs-0.5.6-py3-none-manylinux_2_28_x86_64.whl | Python 3 | none | Linux glibc 2.28+ x86-64 | Details for aichs-0.5.6-py3-none-manylinux_2_28_x86_64.whl |
| aichs-0.5.6-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details for aichs-0.5.6-py3-none-macosx_11_0_arm64.whl |
Total release size: 14.3 MB
Release files / aichs-0.5.6.tar.gz
| Download URL | aichs-0.5.6.tar.gz |
|---|---|
| Size | 874.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
81fbf35d1d407cf3bde8b27cf6fe2a2472e492d49d30744afc3bca475802be8c
|
|
BLAKE2b-256 checksum How to use checksums |
9c761e1b5438273ed44325bf31daa474fceda0225fad6dd79ccb0c41585a1d50
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency logRelease files / aichs-0.5.6-py3-none-win_amd64.whl
| Download URL | aichs-0.5.6-py3-none-win_amd64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
cc1f037561bdc703f10e7df427f8ab6c29aff65d2ff886dae4b2bf6d5801ae6b
|
|
BLAKE2b-256 checksum How to use checksums |
078b78123c69a8bb9643c1e34e1c424bb6038b049481b83e4b6c3590c85f4f07
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency logRelease files / aichs-0.5.6-py3-none-manylinux_2_28_x86_64.whl
| Download URL | aichs-0.5.6-py3-none-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 9.1 MB |
| Tags | Linux glibc 2.28+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
722d90522727fdcb81a5124dc81c5ba770eadb3e0bbd4b6edf0f0026a84b2aa3
|
|
BLAKE2b-256 checksum How to use checksums |
ccffd2c401d4510b71deebea658c42817637324a2449e7e89270db85741ce636
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency logRelease files / aichs-0.5.6-py3-none-macosx_11_0_arm64.whl
| Download URL | aichs-0.5.6-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.2 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
aefb0b1513f98c0bc89f9f8a5dbb086b93afcda9949fbf8c4047d7ae6f5430b1
|
|
BLAKE2b-256 checksum How to use checksums |
c24367f1bf4b1cdda129a97d36f13e5816d4d32443f8bd24b705dcd9911f9be9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency logSecurity for aichs 0.5.6
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 4 files in this release have been uploaded with provenance metadata.
Attestation for aichs-0.5.6.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.