Skip to main content

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):

  1. talon auth login — provisions ~/.talon/credentials.json with your API key.
  2. claude /login — your local Claude Code CLI must be authenticated.
  3. ~/.claude/settings.json must have permissions.defaultMode: "bypassPermissions" (or you'll see the wrapper report status=done with no files produced — see the talonpilot reproduction in postmortem-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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cogmeta_talon-0.7.85-py3-none-any.whl (161.7 kB view details)

Uploaded Python 3

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

Hashes for cogmeta_talon-0.7.85-py3-none-any.whl
Algorithm Hash digest
SHA256 57abb81f769b2d5f097d2f7490ec7cc9bfd4929c8b1e36c41c41df876b6ac9bf
MD5 0dabb11e5b7127b5e7ac7b75ec0c9087
BLAKE2b-256 9a5811fe2e8e69443a08745f9a24b629f4919e036bc0afa9b0fb8433d4847bed

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page