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 Distribution

cogmeta_talon-0.7.83.tar.gz (204.7 kB view details)

Uploaded Source

Built Distribution

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

cogmeta_talon-0.7.83-py3-none-any.whl (151.3 kB view details)

Uploaded Python 3

File details

Details for the file cogmeta_talon-0.7.83.tar.gz.

File metadata

  • Download URL: cogmeta_talon-0.7.83.tar.gz
  • Upload date:
  • Size: 204.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for cogmeta_talon-0.7.83.tar.gz
Algorithm Hash digest
SHA256 076213a6fca67d07de1ff384802ee95cd730c4d32ad9e3f37433d6802b53c2b5
MD5 e2f86915bc38c35c327fcd1156ea40d9
BLAKE2b-256 d33f1d9b944b7c3b40927f1bf87c943238a4c07d4ddf3058ee498def97dca8cf

See more details on using hashes here.

File details

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

File metadata

  • Download URL: cogmeta_talon-0.7.83-py3-none-any.whl
  • Upload date:
  • Size: 151.3 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.83-py3-none-any.whl
Algorithm Hash digest
SHA256 f6173bf69933184ae5be2a6243d9bd8fc885e69ce444d586aa1d4c788069d071
MD5 af7be876b44ef9f08da50211a15492e8
BLAKE2b-256 88cb27d077b1ce605c4d4baa83a8a6b9a3c65f83d375db9c354607edac897e4c

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