Files and Spaces

Purpose

Tauri desktop browser with agent, browser, DNS, files, node, spaces, and wallet commands.

This page follows the real source shape for Dbrowser and explains the workflow a developer is likely to use first.

Storage contract

Document persistence format, integrity checks, read/write ordering, idempotency, compaction or repair behavior, and how callers recover from partial failures. This section should answer what data is durable and what can be reconstructed.

Primary types to know

• AgentAction — tools/dbrowser/src-tauri/src/commands/agent.rs
• AgentMessage — tools/dbrowser/src-tauri/src/commands/agent.rs
• AgentResponse — tools/dbrowser/src-tauri/src/commands/agent.rs
• AgentStatus — tools/dbrowser/src-tauri/src/commands/agent.rs
• AppState — tools/dbrowser/src-tauri/src/state.rs
• AuditLog — tools/dbrowser/src-tauri/src/commands/agent.rs
• AuditRecord — tools/dbrowser/src-tauri/src/commands/agent.rs
• ChainBalance — tools/dbrowser/src-tauri/src/commands/wallet.rs
• DnsRecord — tools/dbrowser/src-tauri/src/commands/dns.rs
• DomainLookup — tools/dbrowser/src-tauri/src/commands/dns.rs
• DomainSearchResult — tools/dbrowser/src-tauri/src/commands/dns.rs
• FileEntry — tools/dbrowser/src-tauri/src/commands/files.rs

Example shape

# dBrowser exposes Locus drives as "Spaces" via commands::spaces and the
# downloaded-file index via commands::files / commands::downloads.

# List the current user's spaces.
dbrowser spaces ls

# Create a new space backed by a Locus drive.
dbrowser spaces create personal --drive workspace --visibility private

# Show recent downloads (commands::downloads::list).
dbrowser downloads ls --since 7d

# Move a downloaded asset into a space-managed folder.
dbrowser files import ~/Downloads/report.pdf \
  --space personal \
  --to /reports/2026-q1.pdf