mitchuski Nextcloud Push
nextcloud-push is a shell script at ~/bin/nextcloud-push that uploads a single file from the local Nextcloud folder directly to the remote Nextcloud server via WebDAV. It was created to solve a recurring problem: the Nextcloud desktop sync client occasionally fails to upload new wiki page files written by Claude Code, leaving links broken on the live site.
The Problem It Solves
When Claude Code writes a new page file to ~/Nextcloud/fedwiki/{domain}/pages/, the Nextcloud desktop client should detect the new file and upload it automatically. This works most of the time. But the sync client has a bug: it occasionally reports An unexpected error occurred even when the server returns HTTP 201 (success), and marks the file as stuck in an error backoff state.
Worse, for newly created wikis whose pages/ folder has never been synced before, the client may delete newly written files entirely — treating them as "deleted on the remote" rather than "new uploads".
The result: pages written by Claude appear locally but never reach the server, so links on the live site return 404.
How It Works
The script bypasses the desktop client entirely and uploads the file directly using a WebDAV PUT request via curl. Before uploading, it walks the remote directory path and issues MKCOL requests to create any missing parent directories — necessary for new wikis whose folder structure doesn't yet exist on the server.
Authentication uses a Nextcloud App Password (not the login password), stored in the NC_PASSWORD environment variable.
# Push a single page file to the remote server:
nextcloud-push ~/Nextcloud/fedwiki/skill.fedwiki.club/pages/journal-skill
# Push all pages in a wiki at once:
for page in ~/Nextcloud/fedwiki/skill.fedwiki.club/pages/*; do
nextcloud-push "$page"
done
Setup
The script lives at ~/bin/nextcloud-push and is already executable. Two environment variables control it:
NC_USER— Nextcloud usernameNC_PASSWORD— a Nextcloud App Password generated in the Nextcloud security settings
Add both to your shell profile so they are available in every terminal session and to Claude Code:
export NC_USER="your-username"
export NC_PASSWORD="your-app-password-here"
HTTP 201 means a new file was created. HTTP 204 means an existing file was updated. Both are success.
Why Browsing the Web UI Also Fixes It
Browsing to the Nextcloud web UI and navigating into a folder causes the server to emit a push notification via the Nextcloud Notify Push service. The desktop sync client is subscribed to these notifications and wakes from its backoff state when it receives one — which is why navigating to the folder in a browser sometimes triggers an otherwise-stuck sync. nextcloud-push is simply a faster, more reliable version of that same effect.
Related Skills
agentprivacy-wiki-page— how pages are written to the Nextcloud folderagentprivacy-wiki-reindex— rebuild indexes after pages landagentprivacy-wiki-merge— uses this WebDAV push during bulk moves
Verify: agentprivacy.ai · kept by the Librarian 🗃️ in the Tower's Wikis (the git-less onboarding layer) Upstream: skill.fedwiki.club/nextcloud-push — vendored + re-framed; not original agentprivacy authorship