:@@@@@@@@@@@@@=-
@. @@@%-=
@@@ @@
@@+ =+ @@@@@@@@@@@+=+: .
*@@=@@@@%@#%%#****##@@@@@@@*- @@:=
@ @@ *@@@@@@#++ ::=*#% @-=
@- +@@@%* +*%%* .:-
@@@@@@@@@@@@@@@@@ @ @@@#*+#%@*+ @.=
= @%+@@@@@@@@@@@@@@@@@ @#%=+%@+@@@@.+=
@ @#@@@@@@@@@@@@@@@@@@@ . %#+#@+ #+:@==.
@@ @*@@ @@@@@@@@@@@@-=@#%%@ @ +@+%
@% @=@@ @@@@@@@@@@@@.=@%%@@@@:%-@ %%
%@ @=@@ @@ @@@@ =@%#@*@%@*%@ @%
- @=@@ @@ @@@@ +@%#@@@@@*%@ @@
@+@#%%@@@@@@@@@@@@@@@@ +@%%%@.@-%@@@%
@#@@@@@#@@%%%@%@@@@@@@ +@%%%#.=@#@#
@@@%%%@%%%@%%@%@@@@%@@-=%%#@+% +=+
@@@@@@@@@@@@@@@@@@ %%@@*%#
=@ @@@@@@@@@@@@@ @@@@@*=
@@@@@*+ -@@@@@@%# %
-=#@@@@@@@@@@@@@@@@@@-. @@@
██████╗ ██████╗ ███████╗███╗ ███╗ ██████╗
██╔════╝██╔═══██╗╚══███╔╝████╗ ████║██╔═══██╗
██║ ██║ ██║ ███╔╝ ██╔████╔██║██║ ██║
██║ ██║ ██║ ███╔╝ ██║╚██╔╝██║██║ ██║
╚██████╗╚██████╔╝███████╗██║ ╚═╝ ██║╚██████╔╝
╚═════╝ ╚═════╝ ╚══════╝╚═╝ ╚═╝ ╚═════╝
Cozmo
CLI coding agent for your repo. One command. Provider setup. Then it indexes and works.
pip install cozmo-agent
cd ~/your-project
cozmo
Requires Python 3.11+.
What happens
- Install
cozmo-agent(CLI binary is stillcozmo) - Run
cozmoin any project - First run: pick provider → paste key → pick model
- Cozmo writes config, indexes the repo, opens an interactive session
Type questions at the prompt. Exit with Ctrl+C or an empty quit.
cozmo # interactive agent (normal use)
cozmo setup # change provider / model / key
Config (where files land)
| Path | What |
|---|---|
~/.cozmo/config.json |
Global settings + API key (created on first run) |
$XDG_CONFIG_HOME/cozmo/config.json |
Same, if XDG_CONFIG_HOME is set |
<repo>/.cozmo/ |
Index, traces, code graph |
<repo>/.cozmo/config.json |
Optional project overrides |
cozmo config # print exact paths
cozmo config --show # print JSON (key masked)
cozmo doctor # effective settings
Example ~/.cozmo/config.json
{
"provider": "openai",
"model": "gpt-4o-mini",
"api_key": "sk-...",
"allow_write": true,
"allow_shell": false,
"max_agent_steps": 8
}
Load order: CLI flags → COZMO_* env → cwd .env → project config → global config → defaults
Commands
cozmo |
Interactive agent (default) |
cozmo setup |
Interactive reconfigure |
cozmo config |
Config paths |
cozmo index |
Force re-index |
cozmo chat |
LLM only, no tools |
cozmo doctor |
Diagnose settings |
cozmo -m "…" |
Optional one-shot (no REPL) |
Stack (short)
- Owned ReAct loop (no LangChain)
- Tools: read/write, search, semantic search, git, symbols, graphs (shell gated)
- Hybrid RAG: BM25 + embeddings
- Providers: OpenAI, OpenRouter, Ollama, any OpenAI-compatible API
cozmo → config → index → AgentRunner
LLM ↔ tools ↔ your files
Dev
git clone https://github.com/ShashwatXD/cozmo.git
cd cozmo
python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytest -q
Fun fact: Named after Anki Cozmo, the robot pet I always wanted. Learning project, not affiliated. PyPI package is cozmo-agent.
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
cozmo_agent-0.2.0.tar.gz
(76.8 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cozmo_agent-0.2.0.tar.gz.
File metadata
- Download URL: cozmo_agent-0.2.0.tar.gz
- Upload date:
- Size: 76.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6e9109f9029c5496501f55d0dfb67711edfd761c2b14b19c2a2ab656b2b3b0f9
|
|
| MD5 |
3e28f60ac5da71246a8956b30e94d1bb
|
|
| BLAKE2b-256 |
35e5f7bcb12d7ef0e08b58a1923dfc257ba517075a6a16d98688510ab3b8c4f9
|
Provenance
The following attestation bundles were made for cozmo_agent-0.2.0.tar.gz:
Publisher:
publish.yml on ShashwatXD/cozmo
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cozmo_agent-0.2.0.tar.gz -
Subject digest:
6e9109f9029c5496501f55d0dfb67711edfd761c2b14b19c2a2ab656b2b3b0f9 - Sigstore transparency entry: 2414652759
- Sigstore integration time:
-
Permalink:
ShashwatXD/cozmo@d0a0d563f2bc22a6c95029902f61c2ca59128f80 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/ShashwatXD
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@d0a0d563f2bc22a6c95029902f61c2ca59128f80 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file cozmo_agent-0.2.0-py3-none-any.whl.
File metadata
- Download URL: cozmo_agent-0.2.0-py3-none-any.whl
- Upload date:
- Size: 77.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5a647fc707285f5a86ba8070a57a79ab29a249af0b669df9075fe9194b158f91
|
|
| MD5 |
5c13f5096ee2db01f3223850369e2997
|
|
| BLAKE2b-256 |
68ca9f75691c1b401a61433e4c459b49317e63c94a7aac70a956d5c6ecf3c95b
|
Provenance
The following attestation bundles were made for cozmo_agent-0.2.0-py3-none-any.whl:
Publisher:
publish.yml on ShashwatXD/cozmo
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cozmo_agent-0.2.0-py3-none-any.whl -
Subject digest:
5a647fc707285f5a86ba8070a57a79ab29a249af0b669df9075fe9194b158f91 - Sigstore transparency entry: 2414652849
- Sigstore integration time:
-
Permalink:
ShashwatXD/cozmo@d0a0d563f2bc22a6c95029902f61c2ca59128f80 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/ShashwatXD
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@d0a0d563f2bc22a6c95029902f61c2ca59128f80 -
Trigger Event:
workflow_dispatch
-
Statement type:
