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.86-py3-none-any.whl (162.1 kB view details)

Uploaded Python 3

File details

Details for the file cogmeta_talon-0.7.86-py3-none-any.whl.

File metadata

  • Download URL: cogmeta_talon-0.7.86-py3-none-any.whl
  • Upload date:
  • Size: 162.1 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.86-py3-none-any.whl
Algorithm Hash digest
SHA256 15da2e5d137020f1c88711fdf438f47f5a786941523e6e0c7a952aa09a79503c
MD5 26eac13f1dd31f27b8f32425638cc9a9
BLAKE2b-256 81d482493f8927ee3286ea12e47b984c2d14ad9b30c6240a575d9e1175c5041c

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