config.yaml 3.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990
  1. # Trellis Configuration
  2. # Project-level settings for the Trellis workflow system
  3. #
  4. # All values have sensible defaults. Only override what you need.
  5. #-------------------------------------------------------------------------------
  6. # Session Recording
  7. #-------------------------------------------------------------------------------
  8. # Commit message used when auto-committing journal/index changes
  9. # after running add_session.py
  10. session_commit_message: "chore: record journal"
  11. # Maximum lines per journal file before rotating to a new one
  12. max_journal_lines: 2000
  13. #-------------------------------------------------------------------------------
  14. # Session Auto-Commit
  15. #-------------------------------------------------------------------------------
  16. # Auto-commit behavior for session journal + task archive operations.
  17. # - true (default): scripts auto-stage and auto-commit journal / task changes
  18. # after add_session.py / task.py archive runs.
  19. # - false: scripts do not touch git. Files (journal-*.md, task archive moves)
  20. # are still written to disk; you decide whether to git add / commit.
  21. #
  22. # Use `false` if your project's .gitignore intentionally excludes `.trellis/`
  23. # and you want session data kept local-only, or if you prefer to review
  24. # staged changes manually before each commit.
  25. #
  26. # Accepts: true / false / yes / no / 1 / 0 / on / off (case-insensitive).
  27. #
  28. # session_auto_commit: true
  29. #-------------------------------------------------------------------------------
  30. # Task Lifecycle Hooks
  31. #-------------------------------------------------------------------------------
  32. # Shell commands to run after task lifecycle events.
  33. # Each hook receives TASK_JSON_PATH environment variable pointing to task.json.
  34. # Hook failures print a warning but do not block the main operation.
  35. #
  36. # hooks:
  37. # after_create:
  38. # - "echo 'Task created'"
  39. # after_start:
  40. # - "echo 'Task started'"
  41. # after_finish:
  42. # - "echo 'Task finished'"
  43. # after_archive:
  44. # - "echo 'Task archived'"
  45. #-------------------------------------------------------------------------------
  46. # Monorepo / Packages
  47. #-------------------------------------------------------------------------------
  48. # Declare packages for monorepo projects.
  49. # Trellis auto-detects workspaces during `trellis init`, but you can also
  50. # configure them manually here.
  51. #
  52. # packages:
  53. # frontend:
  54. # path: packages/frontend
  55. # backend:
  56. # path: packages/backend
  57. # docs:
  58. # path: docs-site
  59. # type: submodule
  60. # # For polyrepo / meta-repo layouts (independent .git in each subdir),
  61. # # mark the package with `git: true`. The runtime treats it as an
  62. # # independent repository for things like git-context display.
  63. # webapp:
  64. # path: ./webapp
  65. # git: true
  66. # Default package used when --package is not specified.
  67. # default_package: frontend
  68. #-------------------------------------------------------------------------------
  69. # Codex (dispatch behavior)
  70. #-------------------------------------------------------------------------------
  71. # Codex-only knob; other platforms ignore it. Default ("inline") makes the
  72. # main Codex agent edit code directly because Codex sub-agents run with
  73. # `fork_turns="none"` isolation and can't inherit the parent session's
  74. # task context. Set to "sub-agent" to opt into the legacy dispatch model
  75. # (main agent spawns trellis-implement / trellis-check / trellis-research
  76. # sub-agents).
  77. #
  78. # codex:
  79. # dispatch_mode: inline # or "sub-agent" to dispatch trellis-* sub-agents