opencode-manager 0.1.1 → 0.2.0

package/PROJECT-SUMMARY.md

@@ -31,9 +31,12 @@ Key Features
   - Missing-only toggle and bulk selection.
 - Sessions panel
   - Shows session title (or falls back to ID) in the list.
-  - Sort toggle (S) between “updated” and “created”.
+  - Sort toggle (S) between "updated" and "created".
   - Each row shows a timestamp snippet for the active sort (created/updated).
   - Details pane includes title, project ID, updated time, and directory.
+  - Rename sessions inline (Shift+R) with validation.
+  - Move sessions to another project (M) with project selector.
+  - Copy sessions to another project (P) with new session ID generation.
 - Projects ↔ Sessions workflow
   - Pressing Enter on a project jumps to the Sessions tab with the project filter set; status text confirms the active filter.
   - `C` clears the filter (and notifies the user) so global searches go back to all sessions.
@@ -55,13 +58,16 @@ Work Completed
 - Redesigned Help screen into two columns with color-coded sections and key chips; removed wall-of-text effect.
 - Added a small color palette and helper components (Section, Row, Bullet, Columns, KeyChip) to simplify consistent styling.
 - Implemented a global Search bar and input mode:
-  - “/” to start, Enter to apply, Esc or “X” to clear.
+  - "/" to start, Enter to apply, Esc or "X" to clear.
   - Projects: search `projectId` and `worktree`; Sessions: search `title`, `sessionId`, `directory`, `projectId`.
 - Sessions sorting & context:
-  - “S” toggles sort by `updated`/`created`.
+  - "S" toggles sort by `updated`/`created`.
   - Show per-row description with the relevant timestamp.
 - Fixed OpenTUI text rendering error by filtering whitespace-only raw text in layout helpers and by removing nested `<text>` nodes around key chips.
 - Verified via `bun run tui` (tmux socket creation is blocked in this environment, but direct run works).
+- Added session rename feature (Shift+R): inline text input with validation, updates JSON file, refreshes list.
+- Added session move feature (M): select target project, relocate session JSON, update projectID field.
+- Added session copy feature (P): select target project, create new session with generated ID, preserve original.
 
 How To Run
 ----------
@@ -71,7 +77,7 @@ How To Run
 - Keys:
   - Global: `Tab`/`1`/`2` switch tabs, `/` search, `X` clear search, `R` reload, `Q` quit, `?` help
   - Projects: `Space` select, `A` select all, `M` toggle missing, `D` delete, `Enter` view sessions
-  - Sessions: `Space` select, `S` sort, `D` delete, `C` clear project filter, `Enter` details
+  - Sessions: `Space` select, `S` sort, `D` delete, `Y` copy ID, `Shift+R` rename, `M` move, `P` copy, `C` clear filter
 - Optional tmux usage (when permitted): `tmux new -s opencode-tui 'bun run tui'`
 - CLI help: `bun run tui -- --help` (or `bunx opencode-manager -- --help`, or `manage_opencode_projects.py -- --help`) prints the built-in usage block with key bindings.
 

package/README.md

@@ -1,3 +1,6 @@
+> **Note:** This is an independent, community-maintained project created by fans of OpenCode. We are not affiliated with SST Corp. or the official OpenCode project. For the official OpenCode CLI, visit [opencode.ai](https://opencode.ai).
+
+
 # OpenCode Metadata Manager
 
 Terminal UI for inspecting, filtering, and pruning OpenCode metadata stored on disk. The app is written in TypeScript, runs on Bun, and renders with [`@opentui/react`](https://github.com/open-tui/opentui).
@@ -18,9 +21,12 @@ Terminal UI for inspecting, filtering, and pruning OpenCode metadata stored on d
 
 ## Features
 - List both OpenCode projects and sessions from a local metadata root.
-- Filter by “missing only”, bulk-select, and delete metadata safely.
+- Filter by "missing only", bulk-select, and delete metadata safely.
 - Jump from a project directly to its sessions and keep contextual filters.
 - Global search bar (`/` to focus, `Enter` to apply, `Esc` or `X` to clear).
+- Rename sessions inline (`Shift+R`) with title validation.
+- Move sessions between projects (`M`) preserving session ID.
+- Copy sessions to other projects (`P`) with new session ID generation.
 - Rich help overlay with live key hints (`?` or `H`).
 - Zero-install via `bunx` so even CI shells can run it without cloning.
 
@@ -56,7 +62,7 @@ bun run tui -- --root ~/.local/share/opencode
 Keyboard reference:
 - **Global**: `Tab`/`1`/`2` switch tabs, `/` search, `X` clear search, `R` reload, `Q` quit, `?` help.
 - **Projects**: `Space` toggle selection, `A` select all, `M` missing-only filter, `D` delete, `Enter` jump to Sessions.
-- **Sessions**: `Space` select, `S` toggle updated/created sort, `D` delete, `C` clear project filter, `Enter` details.
+- **Sessions**: `Space` select, `S` toggle sort, `D` delete, `Y` copy ID, `Shift+R` rename, `M` move to project, `P` copy to project, `C` clear filter.
 
 ## Development Workflow
 1. Install dependencies with `bun install`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-manager",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Terminal UI for inspecting OpenCode metadata stores.",
   "type": "module",
   "license": "MIT",
@@ -9,7 +9,7 @@
     "bun": ">=1.3.0"
   },
   "bin": {
-    "opencode-manager": "./src/bin/opencode-manager.ts"
+    "opencode-manager": "src/bin/opencode-manager.ts"
   },
   "files": [
     "src",

package/src/lib/opencode-data.ts

@@ -309,3 +309,140 @@ export function describeSession(record: SessionRecord, options?: { fullPath?: bo
 export async function ensureDirectory(path: string): Promise<void> {
   await fs.mkdir(dirname(path), { recursive: true })
 }
+
+export async function updateSessionTitle(filePath: string, newTitle: string): Promise<void> {
+  const payload = await readJsonFile<any>(filePath)
+  if (!payload) {
+    throw new Error(`Session file not found or unreadable: ${filePath}`)
+  }
+  payload.title = newTitle
+  payload.time = payload.time || {}
+  payload.time.updated = Date.now()
+  await fs.writeFile(filePath, JSON.stringify(payload, null, 2), 'utf8')
+}
+
+export async function copySession(
+  session: SessionRecord,
+  targetProjectId: string,
+  root: string = DEFAULT_ROOT
+): Promise<SessionRecord> {
+  const payload = await readJsonFile<any>(session.filePath)
+  if (!payload) {
+    throw new Error(`Session file not found: ${session.filePath}`)
+  }
+
+  // Generate new session ID
+  const newSessionId = `session_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`
+
+  // Update payload for new session
+  payload.id = newSessionId
+  payload.projectID = targetProjectId
+  payload.time = payload.time || {}
+  payload.time.created = Date.now()
+  payload.time.updated = Date.now()
+
+  // Ensure target directory exists
+  const targetDir = join(root, 'storage', 'session', targetProjectId)
+  await ensureDirectory(join(targetDir, 'dummy'))
+
+  // Write new session file
+  const targetPath = join(targetDir, `${newSessionId}.json`)
+  await fs.writeFile(targetPath, JSON.stringify(payload, null, 2), 'utf8')
+
+  // Return new session record
+  return {
+    index: 0,
+    filePath: targetPath,
+    sessionId: newSessionId,
+    projectId: targetProjectId,
+    directory: session.directory,
+    title: session.title,
+    version: session.version,
+    createdAt: new Date(),
+    updatedAt: new Date()
+  }
+}
+
+export async function moveSession(
+  session: SessionRecord,
+  targetProjectId: string,
+  root: string = DEFAULT_ROOT
+): Promise<SessionRecord> {
+  const payload = await readJsonFile<any>(session.filePath)
+  if (!payload) {
+    throw new Error(`Session file not found: ${session.filePath}`)
+  }
+
+  payload.projectID = targetProjectId
+  payload.time = payload.time || {}
+  payload.time.updated = Date.now()
+
+  // Ensure target directory exists
+  const targetDir = join(root, 'storage', 'session', targetProjectId)
+  await ensureDirectory(join(targetDir, 'dummy'))
+
+  // Write to new location
+  const targetPath = join(targetDir, `${session.sessionId}.json`)
+  await fs.writeFile(targetPath, JSON.stringify(payload, null, 2), 'utf8')
+
+  // Remove old file
+  await fs.unlink(session.filePath)
+
+  return {
+    ...session,
+    filePath: targetPath,
+    projectId: targetProjectId,
+    updatedAt: new Date()
+  }
+}
+
+export interface BatchOperationResult {
+  succeeded: { session: SessionRecord; newRecord: SessionRecord }[]
+  failed: { session: SessionRecord; error: string }[]
+}
+
+export async function copySessions(
+  sessions: SessionRecord[],
+  targetProjectId: string,
+  root?: string
+): Promise<BatchOperationResult> {
+  const succeeded: BatchOperationResult['succeeded'] = []
+  const failed: BatchOperationResult['failed'] = []
+
+  for (const session of sessions) {
+    try {
+      const newRecord = await copySession(session, targetProjectId, root)
+      succeeded.push({ session, newRecord })
+    } catch (error) {
+      failed.push({
+        session,
+        error: error instanceof Error ? error.message : String(error)
+      })
+    }
+  }
+
+  return { succeeded, failed }
+}
+
+export async function moveSessions(
+  sessions: SessionRecord[],
+  targetProjectId: string,
+  root?: string
+): Promise<BatchOperationResult> {
+  const succeeded: BatchOperationResult['succeeded'] = []
+  const failed: BatchOperationResult['failed'] = []
+
+  for (const session of sessions) {
+    try {
+      const newRecord = await moveSession(session, targetProjectId, root)
+      succeeded.push({ session, newRecord })
+    } catch (error) {
+      failed.push({
+        session,
+        error: error instanceof Error ? error.message : String(error)
+      })
+    }
+  }
+
+  return { succeeded, failed }
+}

package/src/opencode-tui.tsx

@@ -11,6 +11,7 @@ import React, {
   useState,
 } from "react"
 import { resolve } from "node:path"
+import { exec } from "node:child_process"
 import {
   DEFAULT_ROOT,
   ProjectRecord,
@@ -23,6 +24,12 @@ import {
   formatDisplayPath,
   loadProjectRecords,
   loadSessionRecords,
+  updateSessionTitle,
+  copySession,
+  moveSession,
+  copySessions,
+  moveSessions,
+  BatchOperationResult,
 } from "./lib/opencode-data"
 
 type TabKey = "projects" | "sessions"
@@ -75,6 +82,18 @@ const PALETTE = {
   muted: "#9ca3af", // gray
 } as const
 
+function copyToClipboard(text: string): void {
+  const cmd = process.platform === "darwin" ? "pbcopy" : "xclip -selection clipboard"
+  const proc = exec(cmd, (error) => {
+    if (error) {
+      // We can't easily notify from here without context, but it's a best effort
+      console.error("Failed to copy to clipboard:", error)
+    }
+  })
+  proc.stdin?.write(text)
+  proc.stdin?.end()
+}
+
 type ChildrenProps = { children: React.ReactNode }
 
 const Section = ({ title, children }: { title: string } & ChildrenProps) => (
@@ -125,6 +144,62 @@ const Columns = ({ children }: ChildrenProps) => {
 
 const KeyChip = ({ k }: { k: string }) => <text fg={PALETTE.key}>[{k}]</text>
 
+type ProjectSelectorProps = {
+  projects: ProjectRecord[]
+  cursor: number
+  onCursorChange: (index: number) => void
+  onSelect: (project: ProjectRecord) => void
+  onCancel: () => void
+  operationMode: 'move' | 'copy'
+  sessionCount: number
+}
+
+const ProjectSelector = ({
+  projects,
+  cursor,
+  onCursorChange,
+  onSelect,
+  onCancel,
+  operationMode,
+  sessionCount
+}: ProjectSelectorProps) => {
+  const options: SelectOption[] = projects.map((p, idx) => ({
+    name: `${formatDisplayPath(p.worktree)} (${p.projectId})`,
+    description: p.state,
+    value: idx
+  }))
+
+  return (
+    <box
+      title={`Select Target Project (${operationMode} ${sessionCount} session${sessionCount > 1 ? 's' : ''})`}
+      style={{
+        border: true,
+        borderColor: operationMode === 'move' ? PALETTE.key : PALETTE.accent,
+        padding: 1,
+        position: 'absolute',
+        top: 5,
+        left: 5,
+        right: 5,
+        bottom: 5,
+        zIndex: 100
+      }}
+    >
+      <select
+        options={options}
+        selectedIndex={cursor}
+        onChange={onCursorChange}
+        onSelect={(idx) => {
+          const project = projects[idx]
+          if (project) onSelect(project)
+        }}
+        focused={true}
+        showScrollIndicator
+      />
+      <text fg={PALETTE.muted}>Enter to select, Esc to cancel</text>
+    </box>
+  )
+}
+
 const ProjectsPanel = forwardRef<PanelHandle, ProjectsPanelProps>(function ProjectsPanel(
   { root, active, locked, searchQuery, onNotify, requestConfirm, onNavigateToSessions },
   ref,
@@ -390,6 +465,12 @@ const SessionsPanel = forwardRef<PanelHandle, SessionsPanelProps>(function Sessi
   const [cursor, setCursor] = useState(0)
   const [selectedIndexes, setSelectedIndexes] = useState<Set<number>>(new Set())
   const [sortMode, setSortMode] = useState<"updated" | "created">("updated")
+  const [isRenaming, setIsRenaming] = useState(false)
+  const [renameValue, setRenameValue] = useState('')
+  const [isSelectingProject, setIsSelectingProject] = useState(false)
+  const [operationMode, setOperationMode] = useState<'move' | 'copy' | null>(null)
+  const [availableProjects, setAvailableProjects] = useState<ProjectRecord[]>([])
+  const [projectCursor, setProjectCursor] = useState(0)
 
   const visibleRecords = useMemo(() => {
     const sorted = [...records].sort((a, b) => {
@@ -527,12 +608,103 @@ const SessionsPanel = forwardRef<PanelHandle, SessionsPanelProps>(function Sessi
     })
   }, [selectedSessions, onNotify, requestConfirm, refreshRecords])
 
+  const executeRename = useCallback(async () => {
+    if (!currentSession || !renameValue.trim()) {
+      onNotify('Title cannot be empty', 'error')
+      setIsRenaming(false)
+      return
+    }
+    if (renameValue.length > 200) {
+      onNotify('Title too long (max 200 characters)', 'error')
+      return
+    }
+    try {
+      await updateSessionTitle(currentSession.filePath, renameValue.trim())
+      onNotify(`Renamed to "${renameValue.trim()}"`)
+      setIsRenaming(false)
+      setRenameValue('')
+      await refreshRecords(true)
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error)
+      onNotify(`Rename failed: ${msg}`, 'error')
+    }
+  }, [currentSession, renameValue, onNotify, refreshRecords])
+
+  const executeTransfer = useCallback(async (
+    targetProject: ProjectRecord,
+    mode: 'move' | 'copy'
+  ) => {
+    setIsSelectingProject(false)
+    setOperationMode(null)
+
+    const operationFn = mode === 'move' ? moveSessions : copySessions
+    const result = await operationFn(selectedSessions, targetProject.projectId, root)
+
+    setSelectedIndexes(new Set())
+
+    const successCount = result.succeeded.length
+    const failCount = result.failed.length
+    const verb = mode === 'move' ? 'moved' : 'copied'
+
+    if (failCount === 0) {
+      onNotify(`Successfully ${verb} ${successCount} session(s) to ${targetProject.projectId}`)
+    } else {
+      onNotify(
+        `${verb} ${successCount} session(s), ${failCount} failed`,
+        'error'
+      )
+    }
+
+    await refreshRecords(true)
+  }, [selectedSessions, root, onNotify, refreshRecords])
+
   const handleKey = useCallback(
     (key: KeyEvent) => {
       if (!active || locked) {
         return
       }
 
+      // Handle project selection mode
+      if (isSelectingProject) {
+        if (key.name === 'escape') {
+          setIsSelectingProject(false)
+          setOperationMode(null)
+          return
+        }
+        if (key.name === 'return' || key.name === 'enter') {
+          const targetProject = availableProjects[projectCursor]
+          if (targetProject && operationMode) {
+            void executeTransfer(targetProject, operationMode)
+          }
+          return
+        }
+        // Let select component handle up/down via onCursorChange
+        return
+      }
+
+      // Handle rename mode - takes precedence over other key handling
+      if (isRenaming) {
+        if (key.name === 'escape') {
+          setIsRenaming(false)
+          setRenameValue('')
+          return
+        }
+        if (key.name === 'return' || key.name === 'enter') {
+          void executeRename()
+          return
+        }
+        if (key.name === 'backspace') {
+          setRenameValue(prev => prev.slice(0, -1))
+          return
+        }
+        const ch = key.sequence
+        if (ch && ch.length === 1 && !key.ctrl && !key.meta) {
+          setRenameValue(prev => prev + ch)
+          return
+        }
+        return
+      }
+
       const letter = key.sequence?.toLowerCase()
       if (key.name === "space") {
         key.preventDefault()
@@ -555,6 +727,58 @@ const SessionsPanel = forwardRef<PanelHandle, SessionsPanelProps>(function Sessi
         requestDeletion()
         return
       }
+      if (letter === "y") {
+        if (currentSession) {
+          copyToClipboard(currentSession.sessionId)
+          onNotify(`Copied ID ${currentSession.sessionId} to clipboard`)
+        }
+        return
+      }
+      // Rename with Shift+R (uppercase R)
+      if (key.sequence === 'R') {
+        if (currentSession) {
+          setIsRenaming(true)
+          setRenameValue(currentSession.title || '')
+        }
+        return
+      }
+      // Move with M key
+      if (letter === 'm') {
+        if (selectedSessions.length === 0) {
+          onNotify('No sessions selected for move', 'error')
+          return
+        }
+        // Load projects for selection
+        loadProjectRecords({ root }).then(projects => {
+          // Filter out current project if filtering by project
+          const filtered = projectFilter
+            ? projects.filter(p => p.projectId !== projectFilter)
+            : projects
+          setAvailableProjects(filtered)
+          setProjectCursor(0)
+          setOperationMode('move')
+          setIsSelectingProject(true)
+        }).catch(err => {
+          onNotify(`Failed to load projects: ${err.message}`, 'error')
+        })
+        return
+      }
+      // Copy with P key
+      if (letter === 'p') {
+        if (selectedSessions.length === 0) {
+          onNotify('No sessions selected for copy', 'error')
+          return
+        }
+        loadProjectRecords({ root }).then(projects => {
+          setAvailableProjects(projects)
+          setProjectCursor(0)
+          setOperationMode('copy')
+          setIsSelectingProject(true)
+        }).catch(err => {
+          onNotify(`Failed to load projects: ${err.message}`, 'error')
+        })
+        return
+      }
       if (key.name === "return" || key.name === "enter") {
         if (currentSession) {
           const title = currentSession.title && currentSession.title.trim().length > 0 ? currentSession.title : currentSession.sessionId
@@ -563,7 +787,7 @@ const SessionsPanel = forwardRef<PanelHandle, SessionsPanelProps>(function Sessi
         return
       }
     },
-    [active, locked, currentSession, projectFilter, onClearFilter, onNotify, requestDeletion, toggleSelection],
+    [active, locked, currentSession, projectFilter, onClearFilter, onNotify, requestDeletion, toggleSelection, isRenaming, executeRename, isSelectingProject, availableProjects, projectCursor, operationMode, executeTransfer, selectedSessions, root],
   )
 
   useImperativeHandle(
@@ -590,9 +814,32 @@ const SessionsPanel = forwardRef<PanelHandle, SessionsPanelProps>(function Sessi
     >
       <box flexDirection="column" marginBottom={1}>
         <text>Filter: {projectFilter ? `project ${projectFilter}` : "none"} | Sort: {sortMode} | Search: {searchQuery || "(none)"} | Selected: {selectedIndexes.size}</text>
-        <text>Keys: Space select, S sort, D delete, C clear filter, Enter details, Esc clear</text>
+        <text>Keys: Space select, S sort, D delete, Y copy ID, Shift+R rename, M move, P copy, C clear filter</text>
       </box>
 
+      {isRenaming ? (
+        <box style={{ border: true, borderColor: PALETTE.key, padding: 1, marginBottom: 1 }}>
+          <text>Rename: </text>
+          <text fg={PALETTE.key}>{renameValue}</text>
+          <text fg={PALETTE.muted}> (Enter confirm, Esc cancel)</text>
+        </box>
+      ) : null}
+
+      {isSelectingProject && operationMode ? (
+        <ProjectSelector
+          projects={availableProjects}
+          cursor={projectCursor}
+          onCursorChange={setProjectCursor}
+          onSelect={(project) => executeTransfer(project, operationMode)}
+          onCancel={() => {
+            setIsSelectingProject(false)
+            setOperationMode(null)
+          }}
+          operationMode={operationMode}
+          sessionCount={selectedSessions.length}
+        />
+      ) : null}
+
       {error ? (
         <text fg="red">{error}</text>
       ) : loading ? (
@@ -613,7 +860,7 @@ const SessionsPanel = forwardRef<PanelHandle, SessionsPanelProps>(function Sessi
                 onNotify(`Session ${title} [${session.sessionId}] → ${formatDisplayPath(session.directory)}`)
               }
             }}
-            focused={active && !locked}
+            focused={active && !locked && !isSelectingProject && !isRenaming}
             showScrollIndicator
             showDescription={false}
             wrapSelection={false}
@@ -628,6 +875,7 @@ const SessionsPanel = forwardRef<PanelHandle, SessionsPanelProps>(function Sessi
               <text>Updated: {formatDate(currentSession.updatedAt || currentSession.createdAt)}</text>
               <text>Directory:</text>
               <text>{formatDisplayPath(currentSession.directory, { fullPath: true })}</text>
+              <text fg={PALETTE.muted} style={{ marginTop: 1 }}>Press Y to copy ID</text>
             </box>
           ) : null}
         </box>
@@ -755,6 +1003,22 @@ const HelpScreen = ({ onDismiss }: { onDismiss: () => void }) => {
               <KeyChip k="D" />
               <text> — With confirmation</text>
             </Bullet>
+            <Bullet>
+              <text>Copy ID: </text>
+              <KeyChip k="Y" />
+            </Bullet>
+            <Bullet>
+              <text>Rename: </text>
+              <KeyChip k="Shift+R" />
+            </Bullet>
+            <Bullet>
+              <text>Move to project: </text>
+              <KeyChip k="M" />
+            </Bullet>
+            <Bullet>
+              <text>Copy to project: </text>
+              <KeyChip k="P" />
+            </Bullet>
             <Bullet>
               <text>Show details: </text>
               <KeyChip k="Enter" />