Skip to main content

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.

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)

Source distribution for aichs 0.5.6
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)

Table of built distributions (wheels) for aichs 0.5.6
File Interpreter ABI Platform Actions
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 log

Release 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 log

Release 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 log

Release 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 log

Security 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.

Select from 4 files

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 log

A 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.

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