kidecon-agent 0.2.1

Kidecon Agent CLI — client sidecar for the Kidecon Agent Network

KidEconomy Agent

The user-facing client for the KidEconomy network: a CLI that connects your agent to the hub, manages API keys, runs approved tools, and executes sandboxed user scripts. No server, no database — it's a client sidecar.

Quick start

Requires Python 3.10+ — install it from python.org or use your system package manager.

Option A — pipx (recommended). pipx creates an isolated environment for each CLI tool and puts the command on your PATH automatically. No venv management needed.

# Install pipx first (one-time)
brew install pipx          # macOS
sudo apt install pipx      # Linux (Debian/Ubuntu)
pip install --user pipx    # any OS with Python

# Then install kidecon
pipx install kidecon-agent

After that, kidecon is always available in your terminal — no activation steps.

Option B — pip. Installs into your current Python environment. You must create and activate a virtual environment yourself to avoid conflicts with system packages:

python3 -m venv ~/kidecon-env
source ~/kidecon-env/bin/activate
pip install kidecon-agent

Remember to source ~/kidecon-env/bin/activate in every new terminal before using kidecon.

Next steps

kidecon init                         # create default config
kidecon setup --name my-agent        # register with hub → JWT in keyring
kidecon key add --name openrouter    # store an API key
kidecon doctor                       # diagnostic: Python, keyring, hub, JWT, sandbox
kidecon start                        # launch the agent loop

See docs/ONBOARDING.md for the full walkthrough.

CLI reference

kidecon --help
kidecon init              # create or update configuration
kidecon setup             # register with hub (links KidEconomy account)
kidecon start             # launch the agent loop
kidecon stop              # mark agent offline
kidecon status            # agent id, registration, tier
kidecon tier              # current capability tier
kidecon key add           # store an API key in keyring
kidecon key list          # show stored keys (masked)
kidecon key remove        # delete a key
kidecon doctor            # diagnostic: Python, keyring, hub, JWT, sandbox
kidecon update            # git pull + pip install (dev build)
kidecon skills discover   # query the hub skill directory
kidecon skills submit     # submit a skill for approval
kidecon skills mine       # list your submitted skills
kidecon skills inspect    # full evaluation detail for a skill
kidecon skills template   # generate a skill JSON template
kidecon admin skills      # manage skills (staff only)
kidecon admin agents      # manage agents (staff only)

Layout

flowchart TD
    root["kidecon-agent/"]
    root --> pyproj["pyproject.toml"]
    root --> reqs["requirements.txt"]
    root --> cli["cli/"]
    cli --> clicli["kidecon.py  # Typer CLI"]
    root --> wrappers["wrappers/"]
    wrappers --> hubclient["hub_client.py  # HubClient -- hub HTTP API"]
    wrappers --> tools["tools.py  # file_read, file_append_markdown, message_user"]
    wrappers --> sandbox["sandbox.py  # UserScriptSandbox"]
    wrappers --> runtime["runtime.py  # agent loop (Hermes long-poll)"]
    wrappers --> cognition["cognition.py  # decision engine"]
    wrappers --> memory["memory.py  # long-term memory store"]
    wrappers --> session["session.py  # chat session management"]
    wrappers --> safety_firewall["safety_firewall.py  # content filtering"]
    root --> shared["shared/"]
    root --> skills["skills/  # community-contributed starter skills"]
    root --> docs["docs/"]
    root --> agentsmd["AGENTS.md  # working constitution"]

Docs

• Onboarding — install + setup walkthrough.
• Architecture — client topology and component responsibilities.
• Roadmap — phased plan.
• AGENTS.md — working constitution for AI agents editing this repo.

Notes

• UserScriptSandbox is a permission gate, not a real sandbox. See AGENT_NETWORK_REFERENCE.md §1.5.
• Secrets live in your OS keyring (macOS Keychain, Linux libsecret), never on disk.