AiCippy
An autonomous development agent that streams from Amazon Bedrock, on the model its backend names. It inspects, reasons, plans, edits, runs, debugs, manually verifies, deploys, remembers, and reports real evidence from your development environment — from a terminal, a TUI, or a browser side panel, all driving the same runtime.
pip install aicippy
aicippy task run "add retry handling to the payment webhook and verify it manually"
One central runtime with explicit provider choice
Everything that reaches the model goes through a single path:
| Concern | The one place it lives |
|---|---|
| Model, endpoint, region, capabilities, tool contract | aicippy.inference.runtime |
| Provider selection | aicippy.inference.select (main or an explicitly chosen fallback) |
| Main inference | aicippy.inference.provider.BedrockProvider (SigV4 → Bedrock Responses) |
| Fallback inference | aicippy.inference.provider.ConverseProvider (Bedrock Converse, selected manually) |
| Live events | aicippy.inference.events.StreamEvent |
| Task execution | aicippy.orchestration.loop.OrchestrationLoop |
| Tools | aicippy.tools.registry.ToolRegistry |
| Local task memory | aicippy.memory.store.MemoryStore |
| Workspace knowledge | aicippy.memory.workspace_memory.WorkspaceMemory (.aicippy/knowledge.json) |
| Cloud knowledge | AgentCore memory, searched through KnowledgeSearch and /kb |
The CLI selects a provider once per session and never switches it
silently. The WebSocket Lambda and browser extension use the main Responses
route from the deployment-generated model.runtime.json.
Documentation
| Guide | Covers |
|---|---|
| Installation & configuration | Install, AWS setup, model access, configuration reference |
| AWS permissions | The exact IAM policy, profiles, and inference profiles |
| CLI usage | Every command, autonomous task modes, memory controls |
| Browser integration | Side panel, shared tasks, browser debugging |
| MCP integration | Discovery, selection, and calling MCP tools |
| Cloud deployment | Deploying the backend and publishing the CLI |
| Architecture | How the runtime, loop, agents, memory and events fit together |
| Troubleshooting | Diagnostics, error categories, and what each one means |
Quick start
# 1. AWS credentials that can call bedrock:InvokeModelWithResponseStream
export AWS_PROFILE=your-profile
# 2. Check the live route end to end
aicippy doctor
# 3. Run an autonomous task
aicippy task run "repair the broken auth flow"
# 4. Or dispatch the specialist fleet for larger work
aicippy task run --multi-agent "migrate the billing service to the new API"
# 5. Resume anything that was interrupted
aicippy task resume
aicippy opens the terminal workspace — a Go Bubble Tea surface that speaks
to this package over newline-delimited JSON. aicippy --pipe reaches the same
runtime and the same command router as plain text, for scripting.
On a normal release launch, AiCippy checks PyPI, refreshes runtime dependencies
with pip's eager strategy or uv --upgrade, verifies the installed release,
and re-executes a fresh process before opening the TUI. A development version
ahead of PyPI is reported without being downgraded. The fresh process then
refreshes the workspace knowledge file and its relevant name-only file map. It
excludes VCS, dependencies, caches, build output, virtual environments, IDE
state, runtime internals, and symlinks. The full map remains local; task prompts
receive a compact summary so repository context does not grow with the tree.
Terminal workspace
The default workspace is the Go Bubble Tea surface. The fixed header shows the selected provider and session; workspace, machine, configured domain, and deployment declarations appear only when the workspace fact source marks them as verified or configured. The footer shows task state, session token use, and the configured context capacity. Streamed tool output and code diffs stay in the same conversation instead of opening a second interactive implementation.
The surface accepts both slash and backslash commands. Useful commands include:
| Command | Purpose |
|---|---|
/mode code |
Add focused implementation and manual-verification guidance to the next task. |
/retry |
Retry the last turn after a transient failure |
/session release-check, /sessions, /export md |
Name the current session, inspect durable task sessions, or export the rendered conversation. |
/workspace, /memory, /history, /diff |
Inspect the workspace facts, durable memory, task history, or current diff. |
/shell git status |
Run an owner-entered workspace command through the shared streamed shell manager. |
/attach path/to/file, /upload, /screenshot, /analyze |
Queue real workspace files or captures for the next request. |
/kb status, /kb search <query>, /kb read <record-id> |
Inspect and search the separate AgentCore knowledge corpus. |
\subagent codex <task> |
Delegate one explicitly authorized task to the installed Codex, Claude, or Gemini subscription CLI. |
/subagent gemini|codex|claude <task> is accepted as well. Delegation uses only
the provider the owner named, keeps the workspace as its working directory,
streams its shell output, and still honors the configured tool approval policy.
It never silently changes to another subscription CLI.
Prompting examples
Use concrete outcomes, constraints, and evidence you expect to see:
Trace the checkout timeout to its canonical owner, make the smallest connected fix,
show the unified diff, and manually exercise the terminal flow that proves it.
Research the current AWS CLI memory-record permissions from primary AWS sources.
Do not change workspace files; cite the result and call out uncertainty.
\subagent codex inspect the migration plan, update only the affected workspace files,
and report changed paths plus manual verification evidence.
The design policy is to keep the main interaction obvious: controls are rounded, their hover state uses an inverse color treatment, and the default dependency floors follow the latest verified stable releases. Dependency resolution can still select newer compatible transitive packages when an upstream package constrains them.
Durable knowledge and resource policy
Workspace facts and proven, evidence-backed task outcomes live in the single
workspace-local .aicippy/knowledge.json file. User-owned notes and learned
facts are preserved across refreshes; cloud knowledge remains a separate corpus.
The Skills Hub freshness writer has a bounded scope of 30 official,
version-pinned instruction-body sources. EventBridge starts the same serialized
CodeBuild refresh every day at 03:15 UTC, with a concurrency limit of one.
/kb sync starts a one-off refresh and /kb status reports its manifest and
freshness result.
The shared shell manager permits at most four live sessions. Each has an owner-selected deadline from 1 to 900 seconds, bounded live previews, process cleanup, and local stdout/stderr evidence logs. This limits active process and UI memory use while preserving task evidence on disk.
Model access and honest recovery
AiCippy does not disguise an unavailable model as a working result. A message
that the model is unavailable for the AWS account is a Bedrock model-entitlement
blocker; request model access through AWS, then retry. A credential or IAM
failure reports its own category, so run aicippy doctor and inspect the exact
response. There is no second model to fall back to: the session reports exactly
why the turn could not run and /retry re-attempts it once the route is
available.
What a task actually does
understand → inspect repo state → plan → select tools → execute → inspect results
→ repair failures → verify → report evidence → preserve state for resume
Every step emits a live event. Nothing is reported as done that was not observed: if a test failed, you get the output; if a step was skipped, you are told.
License
Proprietary — AiVibe Software Services Pvt Ltd. See LICENSE.
1 maintainer
Release files for aicippy 3.12.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| aicippy-3.12.4.tar.gz | 498.7 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| aicippy-3.12.4-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| aicippy-3.12.4-py3-none-manylinux2014_x86_64.whl | Python 3 | none | Linux glibc 2.17+ x86-64 | Details |
| aicippy-3.12.4-py3-none-manylinux2014_aarch64.whl | Python 3 | none | Linux glibc 2.17+ ARM64 | Details |
| aicippy-3.12.4-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
| aicippy-3.12.4-py3-none-macosx_10_13_x86_64.whl | Python 3 | none | macOS 10.13+ x86-64 | Details |
Total release size: 20.2 MB
Release files / aicippy-3.12.4.tar.gz
| Download URL | aicippy-3.12.4.tar.gz |
|---|---|
| Size | 498.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
33387f95e94495006e5bb5d463f2c5c4f72b63d9d3ff1ca539dc9c8b513d0feb
|
|
BLAKE2b-256 checksum How to use checksums |
7181225b77c56d8af493d0cff1cb70e5fa763b7d5f6b82e9556f338466f635c8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / aicippy-3.12.4-py3-none-win_amd64.whl
| Download URL | aicippy-3.12.4-py3-none-win_amd64.whl |
|---|---|
| Size | 4.1 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
a20785e1fe2bd61c1e8547ef6f15a8f514aeef82cd4a8c4cc41e6bba966496da
|
|
BLAKE2b-256 checksum How to use checksums |
ee558ccb99cdb27a82647acb79ae8c53926faf8e7e11c68bc153b34ac6f6d964
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / aicippy-3.12.4-py3-none-manylinux2014_x86_64.whl
| Download URL | aicippy-3.12.4-py3-none-manylinux2014_x86_64.whl |
|---|---|
| Size | 4.0 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
2947f1422a37b2da0e2aaa97753862b6478bc51623db7bcf068163f07f5976d7
|
|
BLAKE2b-256 checksum How to use checksums |
cba93a89f757832c6927f1c5beb7a82256a01cbdbd8ca228b85903a672faebfe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / aicippy-3.12.4-py3-none-manylinux2014_aarch64.whl
| Download URL | aicippy-3.12.4-py3-none-manylinux2014_aarch64.whl |
|---|---|
| Size | 3.7 MB |
| Tags | Linux glibc 2.17+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
680469982bdff18f904d0b77c3f28503dd191a49802017a119d645cb8b16dafa
|
|
BLAKE2b-256 checksum How to use checksums |
6be20ea3b1856dc00c09eda0556bb64a98f95225729c7e342160fb69d8cf5465
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / aicippy-3.12.4-py3-none-macosx_11_0_arm64.whl
| Download URL | aicippy-3.12.4-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.8 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
2ec5680b5977b99fa1ddaa218e43468d0309fac13e113642f3a17a4ea1af4c48
|
|
BLAKE2b-256 checksum How to use checksums |
71f3e749c99cc28919205aff3b21679d1b7e0d89c82fed4e6561391c7a544f25
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / aicippy-3.12.4-py3-none-macosx_10_13_x86_64.whl
| Download URL | aicippy-3.12.4-py3-none-macosx_10_13_x86_64.whl |
|---|---|
| Size | 4.1 MB |
| Tags | Python 3 macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
92740281d03d0713bd90198978e71eb25e70a6e68ec79d72e742687ca59bb4e4
|
|
BLAKE2b-256 checksum How to use checksums |
773621460e3a68850467aad17046fea9c6f5a20c66ad141ae875b278f640765a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
