Your AI agent skills, finally organized. A macOS app to browse, edit, and manage skills across Claude Code, Cursor, Codex, Windsurf, and Amp.
import SwiftUI
import Sparkle
extension Notification.Name {
static let customScanPathsChanged = Notification.Name("customScanPathsChanged")
}
// MARK: - Settings Tab Definition
enum SettingsTab: String, CaseIterable, Identifiable {
case general, library, aiAssist, scanDirs, servers, about
var id: String { rawValue }
var title: String {
switch self {
case .general: "General"
case .library: "Library"
case .aiAssist: "AI Assist"
case .scanDirs: "Scan Directories"
case .servers: "Servers"
case .about: "About"
}
}
var icon: String {
switch self {
case .general: "gearshape"
case .library: "books.vertical"
case .aiAssist: "sparkles"
case .scanDirs: "folder.badge.gearshape"
case .servers: "server.rack"
case .about: "info.circle"
}
}
}
// MARK: - Settings View
struct SettingsView: View {
private static let logger = AppLogger.settings
let updater: SPUUpdater
@State private var selectedTab: SettingsTab = .general
@State private var customPaths: [String] = []
@AppStorage("defaultTool") private var defaultTool: ToolSource = .claude
@FocusState private var navFocused: Bool
var body: some View {
VStack(spacing: 0) {
// Tab bar — focused on open so the keyboard can drive navigation
// immediately; ←/→ move between sections.
HStack(spacing: 1) {
ForEach(SettingsTab.allCases) { tab in
SettingsTabButton(tab: tab, isSelected: selectedTab == tab) {
selectedTab = tab
}
}
}
.padding(.horizontal, 12)
.padding(.top, 8)
.padding(.bottom, 4)
.focusable()
.focused($navFocused)
.focusEffectDisabled()
.onKeyPress(.leftArrow) { selectAdjacentTab(-1) }
.onKeyPress(.rightArrow) { selectAdjacentTab(1) }
.accessibilityElement(children: .contain)
.accessibilityLabel("Settings sections")
Divider()
// Tab content — each pane sizes itself, no outer ScrollView
tabContent
.frame(maxWidth: .infinity, alignment: .leading)
}
.frame(width: 520)
.fixedSize(horizontal: false, vertical: true)
.defaultFocus($navFocused, true)
.onAppear {
loadCustomPaths()
}
}
/// Move the selection one tab left/right, clamped at the ends. Returns
/// `.handled` so the arrow key never falls through to scroll the window.
private func selectAdjacentTab(_ direction: Int) -> KeyPress.Result {
let tabs = SettingsTab.allCases
guard let current = tabs.firstIndex(of: selectedTab) else { return .ignored }
let target = current + direction
guard tabs.indices.contains(target) else { return .handled }
selectedTab = tabs[target]
return .handled
}
@ViewBuilder
private var tabContent: some View {
switch selectedTab {
case .general:
generalSettings
case .library:
LibrarySettingsView()
case .aiAssist:
AgentSettingsView()
case .scanDirs:
scanSettings
case .servers:
RemoteServersSettingsView()
case .about:
aboutView
}
}
private var generalSettings: some View {
VStack(alignment: .leading, spacing: 12) {
Text("General")
.font(.headline)
Picker("Default tool", selection: $defaultTool) {
ForEach(ToolSource.allCases) { tool in
Text(tool.displayName).tag(tool)
}
}
.frame(maxWidth: 300)
}
.padding()
}
private var scanSettings: some View {
VStack(alignment: .leading, spacing: 12) {
Text("Custom Scan Directories")
.font(.headline)
Text("Add a parent directory (e.g. ~/Development) and Chops will scan each project inside it for tool-specific skills and agents.")
.font(.caption)
.foregroundStyle(.secondary)
if !customPaths.isEmpty {
VStack(spacing: 0) {
ForEach(customPaths, id: \.self) { path in
HStack {
Image(systemName: "folder")
Text(path)
.font(.system(.body, design: .monospaced))
.lineLimit(1)
.truncationMode(.middle)
Spacer()
Button {
customPaths.removeAll { $0 == path }
saveCustomPaths()
} label: {
Image(systemName: "minus.circle.fill")
.foregroundStyle(.red)
}
.buttonStyle(.plain)
}
.padding(.vertical, 6)
.padding(.horizontal, 8)
if path != customPaths.last {
Divider()
}
}
}
.background(Color(NSColor.controlBackgroundColor))
.clipShape(RoundedRectangle(cornerRadius: 6))
} else {
Text("No custom directories added.")
.foregroundStyle(.secondary)
.font(.callout)
}
HStack {
Spacer()
Button("Add Directory...") {
let panel = NSOpenPanel()
panel.canChooseFiles = false
panel.canChooseDirectories = true
panel.allowsMultipleSelection = false
if panel.runModal() == .OK, let url = panel.url {
let path = url.path
if !customPaths.contains(path) {
customPaths.append(path)
saveCustomPaths()
}
}
}
}
}
.padding()
}
private var aboutView: some View {
VStack(spacing: 16) {
if let icon = NSApp.applicationIconImage {
Image(nsImage: icon)
.resizable()
.aspectRatio(contentMode: .fit)
.frame(width: 80, height: 80)
}
Text("Chops")
.font(.title)
.fontWeight(.bold)
Text("Version \(appVersion)")
.font(.subheadline)
.foregroundStyle(.secondary)
Text("Your AI skills and agents, finally organized.")
.font(.subheadline)
.foregroundStyle(.secondary)
HStack(spacing: 16) {
Button("Check for Updates") {
updater.checkForUpdates()
}
Button("Website") {
if let url = URL(string: "https://chops.md") { NSWorkspace.shared.open(url) }
}
Button("@Shpigford") {
if let url = URL(string: "https://x.com/Shpigford") { NSWorkspace.shared.open(url) }
}
Button("GitHub") {
if let url = URL(string: "https://github.com/Shpigford/chops") { NSWorkspace.shared.open(url) }
}
}
Text("Free and open source under the MIT License.")
.font(.caption)
.foregroundStyle(.tertiary)
}
.frame(maxWidth: .infinity)
.padding(.vertical, 30)
}
private var appVersion: String {
let version = Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String ?? "?"
let build = Bundle.main.infoDictionary?["CFBundleVersion"] as? String ?? "?"
return "\(version) (\(build))"
}
private func loadCustomPaths() {
customPaths = UserDefaults.standard.stringArray(forKey: "customScanPaths") ?? []
}
private func saveCustomPaths() {
UserDefaults.standard.set(customPaths, forKey: "customScanPaths")
NotificationCenter.default.post(name: .customScanPathsChanged, object: nil)
}
}
// MARK: - Tab Button
private struct SettingsTabButton: View {
let tab: SettingsTab
let isSelected: Bool
let action: () -> Void
var body: some View {
Button(action: action) {
VStack(spacing: 2) {
Image(systemName: tab.icon)
.font(.system(size: 16))
.frame(height: 20)
Text(tab.title)
.font(.caption2)
.lineLimit(1)
}
.frame(maxWidth: .infinity)
.padding(.vertical, 6)
.padding(.horizontal, 4)
.background(isSelected ? Color.accentColor.opacity(0.15) : Color.clear)
.clipShape(RoundedRectangle(cornerRadius: 6))
.contentShape(Rectangle())
}
.buttonStyle(.plain)
.foregroundStyle(isSelected ? .primary : .secondary)
}
}