# Autocommit

> Operate the local auto-commit daemon for this vault. Use when the user wants to start, stop, restart, inspect, debug, or verify the auto-commit system, or asks about background git automation in this workspace.

- **Type:** Skill
- **Install:** `agentstack add skill-theveller-claude-skills-autocommit`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [TheVeller](https://agentstack.voostack.com/s/theveller)
- **Installs:** 0
- **Category:** [Security](https://agentstack.voostack.com/c/security)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [TheVeller](https://github.com/TheVeller)
- **Source:** https://github.com/TheVeller/claude-skills/tree/main/skills/obsidian-vault/autocommit

## Install

```sh
agentstack add skill-theveller-claude-skills-autocommit
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Autocommit

Manage the vault's local auto-commit system safely and consistently.

This skill is for the modular daemon behind:

- `.scripts/auto-commit-control.sh`
- `.scripts/auto-commit.sh`
- `.scripts/auto-commit/`

## Use This Skill For

- starting the auto-commit monitor
- stopping it
- restarting it
- checking status
- reading recent logs
- understanding why it is not committing or not staying alive

Do not use this skill for normal manual git workflows. This is specifically for the background daemon.

## Core Commands

Run from repo root:

```bash
bash .scripts/auto-commit-control.sh start
bash .scripts/auto-commit-control.sh stop
bash .scripts/auto-commit-control.sh status
bash .scripts/auto-commit-control.sh logs
bash .scripts/auto-commit-control.sh restart
```

## Standard Workflow

### 1. Check Status First

Always start with:

```bash
bash .scripts/auto-commit-control.sh status
```

If running, report:
- running/not running
- whether the user actually wants a change

### 2. If Starting

Before starting, verify:
- `fswatch` exists
- there is no obvious git operation in progress

Then run:

```bash
bash .scripts/auto-commit-control.sh start
```

After starting, verify again with `status`.

### 3. If It Fails

Check:

```bash
tail -n 80 .scripts/.auto-commit.log
```

Then inspect:
- `.scripts/auto-commit-control.sh`
- `.scripts/auto-commit.sh`
- `.scripts/auto-commit/core/monitor.sh`
- `.scripts/auto-commit/integrations/obsidian-detector.sh`

Key failure patterns:
- `fswatch` missing
- process starts but dies immediately
- Obsidian Git conflict heuristics skipping too aggressively
- commit generation failing
- push failing while commit succeeds

### 4. If Reviewing Behavior

Useful references:
- `06_Metadata/Tools/Misc/Auto-Commit-System.md`
- `.scripts/auto-commit/README.md`

## Reporting Back

When done, report:
- current daemon state
- what command was run
- whether it is now healthy
- if not healthy, the most likely reason

## Safety

- Do not restart blindly if the user is in the middle of sensitive git operations.
- Do not hide when the daemon is flaky; say whether it truly stayed running.
- Treat nested repos and unrelated git states carefully.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [TheVeller](https://github.com/TheVeller)
- **Source:** [TheVeller/claude-skills](https://github.com/TheVeller/claude-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-theveller-claude-skills-autocommit
- Seller: https://agentstack.voostack.com/s/theveller
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
