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

tj serve state file does not scope multiple configs under one HOME

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

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
68/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Quiet
Tech stack
python
Domain
cli

Research direction

Start in tokenjam/core/server_state.py and trace every reader of server_state_path(), as the issue requests. Find the tests covering daemon startup and tj stop, then run them. Done means two daemons started with different --config values under one HOME have separate state files, and stopping one leaves the other running.

Written by the indexing model from the issue text.

Description

bug good first issue help wanted

Severity: Medium
Model: sonnet

Where: tokenjam/ (sub-repo) — tokenjam/core/server_state.py
Observed: server_state_path() is scoped only by $HOME, so two installs/configs sharing one $HOME overwrite a single PID record and cannot be stopped independently. The daemon-scoping work fixed the machine-wide pgrep collision (cross-$HOME), not the same-$HOME multi-config case.
Fix direction: key the state path by a hash of the resolved config path, and update every reader of server_state_path() accordingly.
Done when: two daemons under one $HOME started with different --config each get their own state file and tj stop terminates only its own.
Ref: review of the tj stop scoping PR (public repo PR 510).

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.