Context intelligence for Agentic Development — MCP server + setup CLI
Project description
Talon
Context intelligence for Agentic Development — graph-based code context for AI coding agents.
Supported Languages
| Language | Extensions | Parser Features |
|---|---|---|
| Python | .py |
Classes, decorators, raise/except, async |
| TypeScript | .ts, .tsx |
Classes, interfaces, arrow functions, ES imports |
| JavaScript | .js, .jsx, .mjs, .cjs |
Arrow functions, ES imports/exports, method chains, error paths |
| Go | .go |
Structs, receiver methods, interfaces, panic/recover |
| Java | .java |
Annotations, constructors, throws, inheritance, enums |
| Rust | .rs |
Structs, traits, impl blocks, enums, panic!/? error paths |
| C# | .cs |
Classes, interfaces, attributes, constructors, throw/catch |
| Kotlin | .kt, .kts |
Data/sealed classes, companion objects, suspend functions |
| Ruby | .rb |
Classes, modules, include/extend, singleton methods, rescue |
| PHP | .php |
Classes, interfaces, traits, enums, namespace imports |
All languages get full-depth parsing: classes/structs, functions/methods, imports, call edges, error flow edges, method chain resolution, and cross-module call edges.
Install
pip install talon
Quick start
# Authenticate with cogmeta.ai (opens browser, no copy/paste)
talon-setup auth login
# Generate .mcp.json for your project
talon-setup init --cloud
Then restart Claude Code — Talon is active.
talon work — SPECx client-pull dispatcher (new in 0.7.80)
Poll the SPECx work queue, run claimed tickets locally via claude -p, stream audit events back, post completion. Closes the loop for client-pull dispatch (Slice 2).
# Smoke-test: claim + start + audit + complete one ticket without invoking claude
talon work --once --dry-run
# Real run: claim and run one ticket via claude -p (180s hard cap)
talon work --once --timeout-seconds 180
# Long-running worker: drain the queue until interrupted
talon work --poll-seconds 5
# Bounded run: process exactly N tickets then exit
talon work --max-runs 10
Prerequisites for the real path (without --dry-run):
talon auth login— provisions~/.talon/credentials.jsonwith your API key.claude /login— your local Claude Code CLI must be authenticated.~/.claude/settings.jsonmust havepermissions.defaultMode: "bypassPermissions"(or you'll see the wrapper reportstatus=donewith no files produced — see the talonpilot reproduction inpostmortem-slice-2-day-2026-05-16.md).
Concurrent agents. Multiple talon work processes can race the same queue safely. Each --client-id gets its own per-second polling budget (server-side rate limit is keyed per client_id). Verified: 3 concurrent agents, 9 tickets, 173 seconds wall-clock, 6/6 pytest passing on produced code.
Sandbox first. talon work writes files into the current working directory and creates branches like specx/T-0042. Use a clean subdirectory:
mkdir specx-work && cd specx-work && git init
talon work --once
git log --all --oneline # see what got produced
On SIGINT (Ctrl-C) / SIGTERM the wrapper POSTs /release on the active claim so the queue doesn't starve.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
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 cogmeta_talon-0.7.85-py3-none-any.whl.
File metadata
- Download URL: cogmeta_talon-0.7.85-py3-none-any.whl
- Upload date:
- Size: 161.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
57abb81f769b2d5f097d2f7490ec7cc9bfd4929c8b1e36c41c41df876b6ac9bf
|
|
| MD5 |
0dabb11e5b7127b5e7ac7b75ec0c9087
|
|
| BLAKE2b-256 |
9a5811fe2e8e69443a08745f9a24b629f4919e036bc0afa9b0fb8433d4847bed
|