mirror of https://github.com/boxpositron/absolute-dotfiles.git synced 2026-02-28 19:50:38 +00:00

Files

David Ibia d928999224 feat(opencode): add with-context custom commands for documentation management

- Add commands: setup-notes, sync-notes, ingest-notes, teleport-notes
- Add commands: validate-notes-config, preview-notes-delegation
- Add vault organization commands: analyze-vault, reorganize-notes
- Update .withcontextconfig.jsonc with delegation patterns
- Archive deprecated with-context.ts plugin

2025-12-28 23:19:59 +01:00

2.9 KiB

Raw Blame History

description, agent, subtask

description	agent	subtask
Ingest local documentation files to Obsidian vault	general	true

Ingest Notes

Scans the current project for documentation files based on .withcontextconfig.jsonc delegation rules and copies them to the Obsidian vault.

What This Command Does

This command copies documentation files from your local project to the Obsidian vault:

Scans project for files matching vault patterns in .withcontextconfig.jsonc
Copies matched files to vault preserving directory structure
Optionally deletes local files after successful copy
Provides dry-run preview mode

Prerequisites:

.withcontextconfig.jsonc must exist (run /setup-notes first if not)
Configuration defines which files have delegation decision "vault"

Your Task

Execute the ingest_notes tool immediately with dry-run by default for safety:

// Check for flags in arguments
const args = '$ARGUMENTS';
const shouldExecute = args.includes('--execute');
const shouldDelete = args.includes('--delete');
const forceDelete = args.includes('--force-delete');

const result = await ingest_notes({
  dry_run: !shouldExecute,
  delete_local_files: shouldDelete,
  force_delete: forceDelete,
});

return result;

Usage:

/ingest-notes - Preview what will be copied (safe, dry-run mode)
/ingest-notes --execute - Copy files to vault (keeps local files)
/ingest-notes --execute --delete - Copy and delete local files
/ingest-notes --execute --delete --force-delete - Force delete even on errors

Important: Use --delete flag only if you want to remove local files after copying!

Parameters

dry_run (optional, default: false)

Preview mode - shows what will happen without making changes:

dry_run: true; // Preview only
dry_run: false; // Execute for real

delete_local_files (optional, default: false)

Whether to delete local files after successful copy to vault:

delete_local_files: false; // Keep local files (default)
delete_local_files: true; // Delete local files after copy

force_delete (optional, default: false)

Force deletion of local files even if some files had errors:

force_delete: false; // Don't delete if errors occurred (default)
force_delete: true; // Delete even if some files failed

Important Notes

Local files are NOT deleted by default - set delete_local_files: true explicitly if desired
Always preview first - Use dry_run: true before executing
The tool automatically checks for .withcontextconfig.jsonc existence
Directory structure is preserved in the vault

/setup-notes - Create configuration file
/preview-notes-delegation - Preview which files will be ingested
/sync-notes - Bidirectional sync (moves files both ways)
/validate-notes-config - Validate configuration

The ingest-notes tool copies local documentation to vault based on delegation rules.

2.9 KiB Raw Blame History