learn-cli

A CLI, MCP server, and web front for learning — a hosted site where humans and agents learn a subject step by step. Fronts the french-cli and spanish-cli language tutors, and generalizes to other learnable domains such as leading teams of agents. The learn command is the local operator surface and how agents drive it.

What you get

• An agent-first CLI cited from teken (afi-cli) — the runtime package has no third-party dependencies.

• A mesh identity — culture.yaml (suffix + backend) and the matching resident prompt file (AGENTS.colleague.md, since this template runs backend: colleague).

• The vendored skill kit (14 skills) under .claude/skills/, cited cite-don't-import from guildmaster, devague, colleague, and eidetic-cli. See docs/skill-sources.md for per-skill provenance.

• A build + deploy baseline — pytest, lint, the agent-first rubric gate, and PyPI Trusted Publishing wired into GitHub Actions.

Related MCP server: simple_mcp

Quickstart

uv sync
uv run pytest -n auto                 # run the test suite
uv run learn whoami      # identity from culture.yaml (command is `learn`)
uv run learn learn       # self-teaching prompt (add --json)
uv run teken cli doctor . --strict    # the agent-first rubric gate CI runs

CLI

Every command supports --json. Results go to stdout, errors/diagnostics to stderr (never mixed). Exit codes: 0 success, 1 user error, 2 environment error, 3+ reserved.

Make it your own

1. Rename the package learn/ and the learn-cli CLI/dist name throughout pyproject.toml, the package, tests/, sonar-project.properties, and this README.md. The name is hard-coded in ~100 places, so list every occurrence first — see the git grep discovery command in CLAUDE.md, the authoritative rename procedure.

2. Edit culture.yaml with your suffix and backend.

3. Rewrite CLAUDE.md for your agent and run /init.

4. Re-vendor only the skills you need from guildmaster (see docs/skill-sources.md).

See CLAUDE.md for the full conventions (version-bump-every-PR, the cicd PR lane, deploy setup).

License

Apache 2.0 — see LICENSE.