dsh-file-claim

When multiple DeepSeek Harness sessions run in parallel on the same workspace, they operate in isolation, leading to file overwrites, stale state remnants, and coordination headaches. The dsh-file-claim plugin addresses these issues by introducing a declarative file protection mechanism: sessions must explicitly 'claim' file ownership before editing, which blocks other sessions from writing to those files, thus preventing conflicts. It also integrates automatic heartbeat refreshes, immediate cleanup of crashed sessions, and an asynchronous pending merge area, allowing file edits to proceed safely without blocking, with automatic Git three-way merges once the owner releases.

Its core capabilities include: claiming and releasing file paths, heartbeat-driven state management, a write guard to intercept unauthorized operations, and comprehensive audit logging for traceability. Ideal for use in continuous integration environments, collaborative team development, or any scenario requiring parallel AI agent work, this zero-dependency, cross-platform DSH-native coordination tool transforms interfering parallel sessions into orderly collaboration for developers and system administrators.