Skip to content

back-399 - Add-configurable-tasksDirectory-for-custom-task-storage-path#550

Open
maeste wants to merge 1 commit into
MrLesk:mainfrom
maeste:BACK-configurable-task-directory
Open

back-399 - Add-configurable-tasksDirectory-for-custom-task-storage-path#550
maeste wants to merge 1 commit into
MrLesk:mainfrom
maeste:BACK-configurable-task-directory

Conversation

@maeste
Copy link
Copy Markdown
Contributor

@maeste maeste commented Feb 25, 2026

Summary

Adding a config parameter for the backlog directory location. Basically, when you initialise the backlog in a project, it creates a backlog directory which always contains the config.yml. In the current main directory, it also contains all backlog databases with tasks, docs, milestones, etc. Now this is configurable, and you can keep in ./backlog/ only the config while the database can be pointed to another_path/backlog. This allows having 2 separate GitHub repositories for backlog and code, which can be beneficial in some cases. It is backwards compatible because the default/blank fall-back to local ./backlog/

Related Tasks

Back-399

📋 Important: All PRs must have an associated task in the backlog.

  • If no task exists, create one first using: backlog task create "Your task title"
  • Follow the task guidelines when creating tasks
  • Tasks should be atomic, testable, and well-defined with clear acceptance criteria

Task Checklist

  • [ x] I have created a corresponding task in backlog/tasks/
  • [ x] The task has clear acceptance criteria
  • [ x] I have added an implementation plan to the task
  • [ x] All acceptance criteria in the task are marked as completed

Testing

Using it in a real project :)

@maeste maeste force-pushed the BACK-configurable-task-directory branch from be8ae38 to 9a447dd Compare February 25, 2026 12:56
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: be8ae38c70

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread src/cli.ts
defaultPort: advancedConfig.defaultPort,
autoOpenBrowser: advancedConfig.autoOpenBrowser,
taskPrefix: taskPrefix || undefined,
tasksDirectory: advancedConfig.tasksDirectory,
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Omit undefined tasksDirectory override on init

This field is always passed into initializeProject, even when the user did not configure a tasks directory. In the re-init path, initializeProject treats the presence of this key as an explicit override and deletes config.tasksDirectory when the value is falsy, so running backlog init on a project that already uses a custom tasks directory can silently reset it to default and make existing tasks appear missing.

Useful? React with 👍 / 👎.

Comment on lines +685 to +686
// Only include tasksDirectory if it's not empty (empty means use default)
...(tasksDirectory ? { tasksDirectory } : {}),
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Return explicit clear for tasksDirectory from wizard

The wizard comment says empty input means “use default”, but this conditional spread drops the key entirely when the user clears the value. In the backlog config advanced-settings flow, the result is merged over existing config, so an omitted key preserves the old custom path and users cannot clear tasksDirectory interactively even after entering an empty value.

Useful? React with 👍 / 👎.

@MrLesk
Copy link
Copy Markdown
Owner

MrLesk commented Mar 1, 2026

@maeste I had a look at the PR but it lacks compatibility with multi branch sync feature. I see the benefit of the feature and I will think at a proper solution.

In the meantime you can use the new CWD feature released recently #536:
export BACKLOG_CWD="path containing backlog folder" && backlog board

@MrLesk
Copy link
Copy Markdown
Owner

MrLesk commented Apr 25, 2026

Alex's Agent: This branch is conflicted and still has unresolved Codex review findings, and Alex already noted the multi-branch sync compatibility issue. Please do not continue this branch as-is; this needs Alex's decision or a fresh approach against the current CWD/root model.

@MrLesk
Copy link
Copy Markdown
Owner

MrLesk commented May 3, 2026

Alex's Agent: I checked this during Alex's open-PR readiness sweep. I am not going to treat it as merge-ready in its current state.

Current blockers:

  • The PR has merge conflicts against current main.
  • The PR title/task use back-399, but current main already has BACK-399 for a different task, so this needs a fresh non-conflicting task ID.
  • The branch is old and touches core task-directory/config behavior, so it should be rebased and revalidated against the current project-root/CWD behavior before review.
  • I do not see a current Codex approval signal for the present branch state.

The idea is still useful, but this needs to be reworked on a fresh task ID and current main before Alex can safely consider merging it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants