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.82.tar.gz (204.3 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.82-py3-none-any.whl (150.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: cogmeta_talon-0.7.82.tar.gz
  • Upload date:
  • Size: 204.3 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.82.tar.gz
Algorithm Hash digest
SHA256 fa99085061c064c03667f91d2af180711e41d3e458fce0b46637b49df6993583
MD5 1a82d65f23a5bb74c48906eb5be33093
BLAKE2b-256 1c4e434dec59ce84b1d6ee4b0acf87724b9c1bdf3a2ac012138fb8f366988ef5

See more details on using hashes here.

File details

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

File metadata

  • Download URL: cogmeta_talon-0.7.82-py3-none-any.whl
  • Upload date:
  • Size: 150.8 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.82-py3-none-any.whl
Algorithm Hash digest
SHA256 33e27f8dae00550ef684e26a2effe197dd42c3468d87d3022a8ef21ef3127aff
MD5 726cb1ca7b9f16d17c1f97015b305acd
BLAKE2b-256 a73ac0447af1f87b28aa3e95f8e9200cbd2e7ffb446e2e6507cf18c7bce80b4c

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