Files
skillshare/website/docs/reference/commands/log.md
T
Willie 2c3003e04f feat(website): complete website revamp — Diátaxis IA, blog, recipes, quickstarts
Restructure the entire documentation site following the Diátaxis framework
(Learn / How-to / Understand / Reference) with new content across 110 files.

## Information Architecture (M1)
- Move all docs to Diátaxis directory structure (learn/, how-to/, understand/, reference/)
- Add client-redirects plugin for old URL compatibility
- Rewrite sidebar, navbar, and footer to match new IA
- Update all internal cross-references

## Homepage + Quickstarts (M2)
- Add scenario entry cards to homepage with hand-drawn design
- 5 quickstart pages: Claude Code, GitHub Copilot (with copy mode recommendation),
  Codex, Multiple Tools, Dev Containers, Playground

## Blog + Changelog (M3)
- Enable Docusaurus blog plugin with authors.yml
- 5 blog posts: 5-min tutorial, managing 50+ skills, skillshare vs vercel/skills
  comparison, team sharing patterns, write your first skill
- Static /changelog page from CHANGELOG.md

## Recipes + Philosophy (M4)
- 5 recipe pages: CI/CD validation, enterprise skills, project setup,
  cross-machine sync, team onboarding
- 3 philosophy pages: why-local-first, security-first, sync-modes-explained

## Content Polish
- Cross-validate all content against CLI source (19 inaccuracies fixed)
- Lowercase "skillshare" throughout (avoid brand conflict with Skillshare Inc.)
- Add registry.yaml to file structure and Key Paths docs
- Highlight multi-platform git support (GitHub, GitLab, Bitbucket, Gitea,
  Azure DevOps, AtomGit, Codeberg)
- Standardize brew install command
- Add AsciinemaPlayer component (cast recordings pending)
2026-02-26 04:52:29 +08:00

7.1 KiB

sidebar_position
sidebar_position
4

log

View persistent operations and audit logs for debugging and compliance.

skillshare log                    # Interactive TUI (default on TTY)
skillshare log --audit            # Show only audit log
skillshare log --tail 50          # Show last 50 entries
skillshare log --cmd sync         # Show only sync entries
skillshare log --status error     # Show only errors
skillshare log --since 2d         # Entries from last 2 days
skillshare log --json             # Output as JSONL
skillshare log --no-tui           # Plain text output
skillshare log --clear            # Clear operations log
skillshare log -p                 # Project operations + audit logs

When to Use

  • Browse and filter log entries interactively
  • Debug what happened during a failed operation
  • Review the audit trail for compliance or troubleshooting
  • Filter logs by command, status, or time range for investigation

Interactive TUI

On a TTY, skillshare log launches an interactive terminal UI with:

  • Fuzzy filtering — type to filter by timestamp, command, status, source, or detail content
  • Keyboard navigation — arrow keys to browse, q to quit
  • Detail panel — shows full timestamp, command, status, duration, source, and structured args for the selected entry
  • Merged view — operations and audit entries are merged and sorted by time when viewing both

Use --no-tui to skip the TUI and print plain text instead:

skillshare log --no-tui           # Plain text output
skillshare log --no-tui | less    # Pipe to pager manually

What Gets Logged

Every mutating CLI and Web UI operation is recorded as a JSONL entry with timestamp, command, status, duration, and contextual args.

Command Log File
install, uninstall, sync, push, pull, collect, backup, restore, update, target, trash, config operations.log
audit audit.log

Web UI actions that call these APIs are logged the same way as CLI operations.

Log Types

Default View

Shows both sections in one output:

  • Operations log
  • Audit log
skillshare log

Audit-Only View

Records security audit scans separately from normal operations.

skillshare log --audit

Filtering

Narrow results by command, status, or time range. When --cmd targets a specific log (e.g. --cmd audit only appears in audit.log), the irrelevant section is automatically skipped.

skillshare log --cmd install              # Only install entries
skillshare log --status error             # Only errors
skillshare log --since 1h                 # Last hour (also: 30m, 2d, 1w)
skillshare log --since 2026-01-15         # Since a specific date
skillshare log --cmd sync --status error  # Combine filters

JSON Output

Output raw JSONL for scripting and automation:

skillshare log --json                     # All entries as JSONL
skillshare log --json --cmd sync          # Filtered JSONL

Example Output (Plain Text)

When using --no-tui or in a non-TTY environment:

┌─ skillshare log ────────────────────────────────────┐
│ Operations (last 2)                                 │
│ mode: global                                        │
│ file: ~/.local/state/skillshare/logs/operations.log │
└─────────────────────────────────────────────────────┘
  TIME             | CMD       | STATUS  | DUR
  -----------------+-----------+---------+--------
  2026-02-10 14:31 | SYNC      | error   | 0.8s
  targets: 3
  failed: 1
  scope: global

  2026-02-10 14:35 | SYNC      | ok      | 0.3s
  targets: 3
  scope: global

┌─ skillshare log ────────────────────────────────────┐
│ Audit (last 1)                                      │
│ mode: global                                        │
│ file: ~/.local/state/skillshare/logs/audit.log      │
└─────────────────────────────────────────────────────┘
  TIME             | CMD       | STATUS  | DUR
  -----------------+-----------+---------+--------
  2026-02-10 14:36 | AUDIT     | blocked | 1.1s
  scope: all-skills
  scanned: 12
  passed: 11
  failed: 1
  failed skills:
    - prompt-injection-skill
    - data-exfil-skill

Log Format

Entries are stored in JSONL format (one JSON object per line):

{"ts":"2026-02-10T14:30:00Z","cmd":"install","args":{"source":"anthropics/skills/pdf"},"status":"ok","ms":1200}
Field Description
ts ISO 8601 timestamp
cmd Command name
args Command-specific context (source, name, target, etc.)
status ok, error, partial, or blocked
msg Error message (when status is not ok)
ms Duration in milliseconds

Log Location

~/.local/state/skillshare/logs/operations.log    # Global operations
~/.local/state/skillshare/logs/audit.log         # Global audit
<project>/.skillshare/logs/operations.log   # Project operations
<project>/.skillshare/logs/audit.log        # Project audit

Track Logs In Git (Project Mode)

Project mode ignores .skillshare/logs/ by default to avoid noisy commits.

If your team wants to version log files, add these user override rules in .skillshare/.gitignore after the managed block:

# User override: track logs
!logs/
!logs/*.log

If your repository root .gitignore also ignores .skillshare/, add matching unignore rules there as well.

Options

Flag Description
-a, --audit Show only audit log
-t, --tail <N> Show last N entries (default: 20)
--cmd <name> Filter by command name (e.g. sync, install, audit)
--status <status> Filter by status (ok, error, partial, blocked)
--since <dur|date> Filter by time (30m, 2h, 2d, 1w, or 2006-01-02)
--json Output raw JSONL (one JSON object per line)
--no-tui Disable interactive TUI, use plain text output
-c, --clear Clear selected log file (operations by default, audit with --audit)
-p, --project Use project-level log
-g, --global Use global log
-h, --help Show help

Web UI

The log is also available in the web dashboard at /log:

skillshare ui
# Navigate to Log page

The Log page provides:

  • Tabs for All, Operations, and Audit
  • Filters for command, status, and time range (1h, 24h, 7d, 30d)
  • Table view with time, command, details, status, and duration
  • Audit detail rows showing failed/warning skill names when present
  • Clear and Refresh controls

See Also

  • audit — Security scanning (logged to audit.log)
  • status — Show current sync state
  • doctor — Diagnose setup issues