Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Offer external-source backfill (langfuse/helicone/otlp) at onboard

Open
#486 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
45/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Quiet
Tech stack
python
Domain
cli, observability

Research direction

Start by reading the tj onboard flow and the existing ingest_langfuse, ingest_helicone, and ingest_otlp adapters to understand how onboarding can invoke them. Check how the CLI handles interactive versus non-interactive input. Done means external backfill is offered explicitly, can be declined, is skipped without waiting on stdin, and stores no credential beyond the one-shot backfill.

Written by the indexing model from the issue text.

Description

enhancement

Context

On-disk backfill sources (claude-code, codex) auto-backfill by default on tj onboard — no opt-out, last 30 days. Good.

The external-source adapters (langfuse, helicone, otlp) are manual-only via tj backfill <source> because they need an API key or a dump file that the onboard flow doesn't collect. So they can never be silently defaulted the way the on-disk sources are — a new user who has history in one of those tools won't get it backfilled unless they know to run the CLI command themselves.

Ask (product decision, not a bug)

Add an optional interactive prompt in tj onboard that offers to pull history from an external source: "Do you also send traces to Langfuse / Helicone, or export OTLP? Paste an API key or a dump file path to backfill it." Skippable, never silent, no credential stored beyond the one-shot backfill.

Constraints

  • Never default silently — always an explicit prompt the user can decline.
  • Non-interactive onboard must skip it (no hang waiting on stdin).
  • Reuse the existing ingest_langfuse / ingest_helicone / ingest_otlp adapters — this is onboard wiring only, no adapter changes.

Deferred design question flagged during the backfill audit — filing so it's not lost.

Dominant language
Python
Stars
122
Forks
35
Avg merge
1d 18h
Merged PRs (30d)
8

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from Metabuilder-Labs/tokenjam

All issues in Metabuilder-Labs/tokenjam

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.