trellis-push

Commits and pushes exact planned files across multiple Git repositories with task progress sync.

Updated Jun 8, 2026
One-click install
npx skills add https://github.com/SilentFlower/flower-trellis --skill trellis-push-silentflower
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: trellis-push
Source: https://github.com/SilentFlower/flower-trellis/tree/main/.agents/skills/trellis-push
Command: npx skills add https://github.com/SilentFlower/flower-trellis --skill trellis-push-silentflower

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It enforces a controlled, confirmation-based Git commit and push workflow that only touches explicitly planned files, preventing accidental commits of unrelated dirty changes and keeping task progress records in sync. ## Core Features & Use Cases - Exact-file commits: Builds a minimal plan of exact files per repository, confirms once with the user, then commits and pushes only those files without using git add . or git add -A. - Multi-repo execution chains: Discovers candidate repositories from .trellis/ config, supports deterministic local generation commands between repos, and stops safely on drift or failure without rolling back successful commits. - Task progress synchronization: After successful business pushes, atomically writes final progress and completion state via task_progress.py, then commits and pushes the task record as a separate exact-file commit. - Use Case: After finishing a feature spanning two packages in a monorepo, run the push phase to confirm a single plan, commit each repo's planned files, push both branches, and mark the active task completed in one controlled flow. ## Quick Start Ask the assistant to commit and push the current task's changes using the trellis-push workflow and confirm the displayed plan.

Frequently Asked Questions about trellis-push

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I commit and push only specific files in Git?▼

Use git add with exact file paths followed by git commit --only -m with the same paths, then push the current branch. This skill automates that flow by planning exact files, confirming once, and verifying the commit contains only planned files.

How to handle commits across multiple repositories in one task?▼

Discover candidate repos from the .trellis config, generate a per-repo plan with exact files and optional deterministic generation commands, then execute in dependency order. On failure, later repos stop while successful commits are preserved without rollback.

Can I commit without pushing to the remote?▼

Yes, request commit-only mode, which performs the same exact local commit but skips the push and remote task progress sync. Auto-loop internal commit-only reuses pre-authorization without asking for confirmation again.

What happens if a push fails partway through a multi-repo plan?▼

Execution stops at the failed repository, previously successful commits and pushes are kept, and no reset, revert, or amend is performed. The result reports the failure location and the exact recovery step, such as retrying only the pending push.

Does this workflow require a clean working tree?▼

No, unrelated dirty, untracked, or staged files are allowed and tracked as retained changes that must remain untouched. Only planned files are committed, and staged retained files are verified unchanged after each commit.

When should I not use this commit workflow?▼

Avoid it during unresolved conflicts, rebase or cherry-pick states, detached HEAD, or when file attribution to the current task is ambiguous. It also does not initiate merges, resolve conflicts, or handle release and archival steps.