Skip to content

Support dual capture modes: interactive and quick #11

@durapensa

Description

@durapensa

Context

Currently, ks launches Claude Code for interactive sessions, but the spec envisions quick command-line event capture.

Proposal

Support both modes:

  1. Quick capture: Direct event creation from command line
  2. Interactive mode: Current Claude Code integration

Implementation Options

Option A: Enhance ks command

ks                    # Launch interactive Claude (current behavior)
ks thought "..."      # Quick capture mode
ks -i                 # Explicit interactive mode

Option B: Separate commands

ks                    # Keep as interactive launcher
kc "thought about X"  # Quick capture (kc = knowledge capture)

Option C: Context-aware

ks                    # If no args, launch interactive
ks [type] [content]   # If args provided, quick capture

Requirements

  • Preserve current interactive workflow
  • Add quick capture without launching Claude
  • Support piped input for quick capture
  • Maintain backwards compatibility
  • Clear documentation on both modes

Example Usage

# Quick capture
ks thought "distributed-systems" "CAP theorem trade-offs in practice"
echo "Insight about X" | ks insight "topic"

# Interactive (current)
ks  # Opens Claude Code with full context

Acceptance Criteria

  • Both capture modes work seamlessly
  • No breaking changes to existing workflow
  • Clear help text explaining both modes
  • Updated CLAUDE.md documentation

Metadata

Metadata

Assignees

No one assigned

    Labels

    priority: mediumImportant but not blockingtype: featureNew functionality or enhancement

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions