burrito.space / peek
experiments in a post-browser web
10
fork

Configure Feed

Select the types of activity you want to include in your feed.

peek / notes / commands.md
at main 1.6 kB view raw view code
dietrich ayala add explicit escape navigational handling, active vs transient mode, and apis
4c0c931b

Commands#

The cmd feature provides a command palette for executing actions, opening URLs, and interacting with the app.

Command Matching & Sorting#

When the user types in the command bar, matching commands are sorted using a three-tier system:

1. Exact Match Priority#

When the input contains parameters (e.g., tag foo), an exact command match is prioritized over prefix matches. This ensures tag foo executes the tag command, not tags.

2. Adaptive Scoring#

The system learns from user behavior using asymptotic scoring:

score = count / (count + k)

Where:

  • count = number of times user selected this command for this typed prefix
  • k = dampening constant (currently 5)

This creates ever-strengthening reinforcement: the more you select a command for a given input, the higher it ranks. The asymptotic curve means early selections have high impact, then it plateaus.

Example: If you type "t" and select "tag" 10 times, the score is 10/(10+5) = 0.67. After 100 selections: 100/(100+5) = 0.95.

Adaptive feedback is stored in localStorage per typed-prefix → command pairs.

3. Match Count (Frecency Fallback)#

If adaptive scores are equal, falls back to raw match count—how many times each command has been used overall.

Implementation#

  • findMatchingCommands(text) in panel.js handles matching and sorting
  • updateAdaptiveFeedback(typed, name) records user selections
  • getAdaptiveScore(typed, name) retrieves learned scores

Storage Keys#

  • cmd:adaptiveFeedback - typed prefix → command selection counts
  • cmd:matchCounts - overall command usage counts