🎁 Get the FREE AI Skills Starter Guide — Subscribe →
BytesAgainBytesAgain
BytesAgain › Skills › Nex Vault
🦀 ClawHub

Nex Vault

by @nexaiguy

Secure local contract and document vault for managing all business agreements and important documents with automatic expiration tracking and compliance alert...

Versionv1.0.0
Downloads302
Stars⭐ 1
#crypto-defi#legal#automation
TERMINAL
clawhub install nex-vault

📖 About This Skill

name: nex-vault description: Secure local contract and document vault for managing all business agreements and important documents with automatic expiration tracking and compliance alerts. Track diverse documents including contracts (contracten), leases (huurovereenkomsten), insurance policies (verzekeringen), service-level agreements (SLAs), warranties (garanties), software licenses (licenties), subscriptions (abonnementen), maintenance agreements, permits, and certifications. Automatically extract expiration dates, renewal deadlines, termination notice periods (opzegingstermijn), payment terms, and auto-renewal clauses from uploaded documents using intelligent OCR and natural language processing. Receive automatic alerts before expiration (configurable warning windows) so you never miss a renewal deadline or critical termination notice deadline. Optional Telegram notifications keep you continuously informed of upcoming expirations, auto-renewal events, and required actions. Track total monthly and yearly costs across all contracts and subscriptions for budgeting and cost optimization. Search and filter documents by type, contracting party name, date range, or extract key clauses (payment terms, liability limits, confidentiality, termination conditions). Monitor document lifecycle with status tracking (active, expired, pending, terminated). Perfect for agency operators, SME owners, directors, and business managers in Belgium who need systematic contract management, compliance maintenance, and avoidance of costly unexpected renewals. version: 1.0.0 metadata: clawdbot: emoji: "🔐" requires: bins: - python3 env: - VAULT_TELEGRAM_TOKEN - VAULT_TELEGRAM_CHAT_ID primaryEnv: "" homepage: https://nex-ai.be files: - "nex-vault.py" - "lib/*" - "setup.sh"

Nex Vault

Local Contract and Document Vault with Expiry Alerts. Track all your important documents—contracts, leases, insurance policies, SLAs, warranties, licenses, subscriptions, certificates, and permits. Never miss an expiration date, renewal deadline, or termination notice period again.

When to Use

Use this skill when the user asks about:

  • Uploading, adding, or tracking contracts, leases, or business documents
  • Tracking insurance policies, warranties, or maintenance agreements
  • Monitoring expiration dates, renewal deadlines, or termination notice periods
  • Getting alerts when documents are about to expire
  • Finding clauses related to termination, renewal, auto-renewal, or payment terms
  • Searching for specific contracts, parties, or document types
  • Viewing upcoming document deadlines or expiring agreements
  • Extracting key dates and clauses from documents
  • Exporting a list of documents for compliance or budgeting
  • Setting up automatic notifications via Telegram
  • Checking monthly or yearly costs for all subscriptions and contracts
  • Documenting termination notice requirements
  • Understanding auto-renewal clauses and renewal periods

    • Trigger phrases in Dutch and English: "contract", "huurovereenkomst", "lease", "verzekering", "insurance", "SLA", "warranty", "garantie", "licentie", "license", "abonnement", "subscription", "vervaldag", "expiry", "opzeg", "termination", "verlenging", "renewal", "clausules", "clauses", "deadlines", "vervaldagen", "documentvault", "document vault", "expires", "verloopt", "notification alerts"

    Quick Setup

    If the database does not exist yet, run the setup script:

    bash setup.sh

    This creates the data directory, installs dependencies, initializes the database, and optionally configures Telegram notifications.

    Available Commands

    The CLI tool is nex-vault. All commands output plain text.

    Adding Documents

    Add a contract or document to the vault:

    # Add a contract with full metadata
nex-vault add /path/to/contract.pdf --type contract --party "Verhuurder NV" --end-date 2027-01-01 --notice-days 90 --auto-renewal --monthly-cost 850
    Add with minimal info, auto-parse dates from PDF
    
nex-vault add /path/to/sla.pdf --type sla --party "CloudProvider"
    Add without a file (just metadata)
    
nex-vault add "Ethias Brandverzekering" --type insurance --end-date 2026-12-31 --yearly-cost 450
    Add with all optional fields
    
nex-vault add /path/to/lease.docx --type lease --party "Makelaars Antwerpen" --start-date 2024-01-01 --end-date 2027-01-01 --notice-days 120 --auto-renewal --renewal-period "1 year" --monthly-cost 1200 --tags "property,residential" --notes "Ground floor, fully renovated"

    Viewing Documents

    Show full details of a document including key clauses and upcoming alerts:

    nex-vault show 
nex-vault show 5

    Listing Documents

    List documents with filters:

    # List all documents
nex-vault list
    List by type
    
nex-vault list --type contract
nex-vault list --type insurance
nex-vault list --type lease
    List by status
    
nex-vault list --status active
nex-vault list --status expired
nex-vault list --status pending
    List by party name
    
nex-vault list --party "Verhuurder"
    List expiring soon (default 90 days)
    
nex-vault list --expiring
    List expiring within custom timeframe
    
nex-vault list --expiring 30

    Searching

    Full-text search across document names, parties, notes, and extracted content:

    nex-vault search "liability insurance"
nex-vault search "payment terms"
nex-vault search "CloudProvider"

    Viewing Expiring Documents

    Show documents expiring within N days:

    nex-vault expiring
nex-vault expiring 30
nex-vault expiring 7

    Managing Alerts

    View and manage expiry alerts:

    # Show upcoming alerts (next 90 days by default)
nex-vault alerts list
nex-vault alerts list --days 30
    Run daily alert check manually
    
nex-vault alerts check
    Send Telegram notifications
    
nex-vault alerts notify
    Mark an alert as sent
    
nex-vault alerts mark-sent

    Parsing Documents

    Extract and re-parse dates and clauses from a document:

    # Auto-extract dates, clauses, and renewal info from file
nex-vault scan /path/to/document.pdf
    Scan and update an existing document entry
    
nex-vault scan  /path/to/new_version.pdf

    Editing Documents

    Update document metadata:

    nex-vault edit  --end-date 2027-06-01
nex-vault edit  --party "New Party Name"
nex-vault edit  --monthly-cost 900
nex-vault edit  --notice-days 60
nex-vault edit  --auto-renewal true
nex-vault edit  --notes "Updated contract terms"

    Removing Documents

    Remove a document from tracking (keeps the file):

    nex-vault remove

    Statistics

    View vault statistics:

    nex-vault stats

    Shows:

  • Total documents and count by type
  • Documents by status (active, expired, pending)
  • Total monthly costs and yearly costs
  • Most common parties

    • Exporting

    Export document list for external use:

    # Export as CSV
nex-vault export csv --output contracts.csv
    Export as JSON
    
nex-vault export json --output vault_backup.json

    Configuration

    Manage Telegram notification settings:

    # Show current configuration
nex-vault config show
    Set Telegram bot token
    
nex-vault config set-telegram-token YOUR_BOT_TOKEN
    Set Telegram chat ID
    
nex-vault config set-telegram-chat YOUR_CHAT_ID
    Test Telegram connection
    
nex-vault config test-telegram

    Example Interactions

    User (Dutch): "Ik heb een nieuwe huurovereenkomst. Upload het en zeg me wanneer ik moet opzeggen." Agent runs: nex-vault add /path/to/lease.pdf --type lease --party "Makelaar" Agent: Extracts dates from the PDF, determines termination notice deadline, and confirms the document is tracked.

    User (English): "Show me all my contracts expiring in the next 30 days." Agent runs: nex-vault expiring 30 Agent: Lists contracts with their expiration dates and termination notice deadlines.

    User (Dutch): "Welke verzekeringen moet ik verlengen?" Agent runs: nex-vault list --type insurance --expiring 90 Agent: Shows insurance policies expiring within 90 days and their renewal deadlines.

    User (English): "Find all documents with auto-renewal clauses." Agent runs: nex-vault search "auto-renewal" then nex-vault list filtered manually Agent: Shows documents with auto-renewal and explains the renewal periods.

    User (Dutch): "Wat zijn mijn totale maandelijkse kosten?" Agent runs: nex-vault stats Agent: Shows the sum of all monthly costs.

    User (English): "Set up Telegram alerts for contracts expiring soon." Agent runs: nex-vault config set-telegram-token and nex-vault config set-telegram-chat Agent: Configures notifications and confirms the connection.

    User (Dutch): "Toon me alle details van contract #3" Agent runs: nex-vault show 3 Agent: Displays full contract details including key clauses and upcoming alerts.

    User (English): "Export all my documents to CSV for my accountant." Agent runs: nex-vault export csv --output vault.csv Agent: Exports and confirms the file location.

    User (Dutch): "Update het einddatum van contract #2 naar volgende maand" Agent runs: nex-vault edit 2 --end-date 2026-05-05 Agent: Confirms the update and recalculates alert deadlines.

    User (English): "Run the daily alert check and send me any expiring documents." Agent runs: nex-vault alerts check then nex-vault alerts notify Agent: Checks for upcoming expirations and sends Telegram notifications if configured.

    Output Parsing

    All CLI output is plain text, structured for easy parsing:

  • Section headers followed by --- separators
  • List items prefixed with -
  • Dates in ISO-8601 format (YYYY-MM-DD)
  • Document statuses: active, expired, pending, terminated
  • Monetary values in euros with 2 decimal places (€ symbol)
  • Every command output ends with [Nex Vault by Nex AI | nex-ai.be]

    • When presenting output to the user, strip the footer line and present the information naturally. Do not show raw database paths or internal details.

    Important Notes

  • All documents and metadata are stored locally at ~/.nex-vault/. No data is sent to external servers.
  • Telegram notifications are optional. If no Telegram credentials are configured, the alerts notify command will skip sending.
  • The skill supports multiple file formats: PDF, DOCX, TXT, and scanned documents (JPG/PNG with OCR).
  • Date extraction is optimized for Belgian and EU contract formats (DD/MM/YYYY, DD-MM-YYYY, etc.).
  • Key clauses are automatically extracted during parsing, including termination, renewal, payment, liability, and confidentiality clauses.
  • File hashes are stored to detect when a document has been replaced or updated.
  • For recurring alerts, set up a cron job or systemd timer to run nex-vault alerts check daily.
  • Auto-renewal detection uses both Dutch and English keywords ("automatische verlenging", "auto-renewal", etc.).

    • Recommended Cron Setup

    To enable daily automatic alert checks, add to your crontab:

    # Run alert check every morning at 08:00
0 8 * * * /home/user/.local/bin/nex-vault alerts check

    Credits

    Built by Nex AI (https://nex-ai.be) - Digital transformation for Belgian SMEs. Author: Kevin Blancaflor License: MIT-0

    ⚡ When to Use

    TriggerAction
    - Uploading, adding, or tracking contracts, leases, or business documents
    - Tracking insurance policies, warranties, or maintenance agreements
    - Monitoring expiration dates, renewal deadlines, or termination notice periods
    - Getting alerts when documents are about to expire
    - Finding clauses related to termination, renewal, auto-renewal, or payment terms
    - Searching for specific contracts, parties, or document types
    - Viewing upcoming document deadlines or expiring agreements
    - Extracting key dates and clauses from documents
    - Exporting a list of documents for compliance or budgeting
    - Setting up automatic notifications via Telegram
    - Checking monthly or yearly costs for all subscriptions and contracts
    - Documenting termination notice requirements
    - Understanding auto-renewal clauses and renewal periods
    Trigger phrases in Dutch and English: "contract", "huurovereenkomst", "lease", "verzekering", "insurance", "SLA", "warranty", "garantie", "licentie", "license", "abonnement", "subscription", "vervaldag", "expiry", "opzeg", "termination", "verlenging", "renewal", "clausules", "clauses", "deadlines", "vervaldagen", "documentvault", "document vault", "expires", "verloopt", "notification alerts"

    ⚙️ Configuration

    Manage Telegram notification settings:

    # Show current configuration
nex-vault config show
    Set Telegram bot token
    
nex-vault config set-telegram-token YOUR_BOT_TOKEN
    Set Telegram chat ID
    
nex-vault config set-telegram-chat YOUR_CHAT_ID
    Test Telegram connection
    
nex-vault config test-telegram