mirror of
https://github.com/tiennm99/ccs.git
synced 2026-07-16 10:16:49 +00:00
Tam Nhu Tran
bc9b04444e
- Add --bare flag to `ccs auth create` to skip shared symlinks (commands/, skills/, agents/, settings.json). Bare profiles are clean instances without ClaudeKit or other global extensions. `ccs sync` respects bare flag and skips re-linking. - Add MCP server sync from global ~/.claude.json to instances. Claude Code stores MCP config in ~/.claude.json (not settings.json), which was invisible to CCS profiles using CLAUDE_CONFIG_DIR isolation. Selective copy of mcpServers key only (not OAuth sessions/caches). `ccs sync` refreshes MCP servers across all non-bare instances. Closes #691 Closes #692
127 lines
3.7 KiB
TypeScript
127 lines
3.7 KiB
TypeScript
/**
|
|
* CCS Configuration Types
|
|
* Source: ~/.ccs/config.json
|
|
*/
|
|
|
|
import type { CLIProxyProvider } from '../cliproxy/types';
|
|
import type { TargetType } from '../targets/target-adapter';
|
|
|
|
/**
|
|
* Profile configuration mapping
|
|
* Maps profile names to settings.json paths
|
|
*/
|
|
export interface ProfilesConfig {
|
|
[profileName: string]: string; // Path to settings.json
|
|
}
|
|
|
|
/**
|
|
* CLIProxy variant configuration
|
|
* Allows user-defined CLIProxy profile variants with custom settings
|
|
* Example: "flash" → gemini provider with gemini-2.5-flash model
|
|
*/
|
|
export interface CLIProxyVariantConfig {
|
|
/** CLIProxy provider to use */
|
|
provider: CLIProxyProvider;
|
|
/** Path to settings.json with custom model configuration (optional) */
|
|
settings?: string;
|
|
/** Account identifier for multi-account support (optional, defaults to 'default') */
|
|
account?: string;
|
|
/** Unique port for variant isolation (8318-8417) */
|
|
port?: number;
|
|
/** Target CLI to use for this variant (default: claude) */
|
|
target?: TargetType;
|
|
}
|
|
|
|
/**
|
|
* CLIProxy variants section in config.json
|
|
* Maps custom profile names to CLIProxy provider + settings
|
|
*/
|
|
export interface CLIProxyVariantsConfig {
|
|
[profileName: string]: CLIProxyVariantConfig;
|
|
}
|
|
|
|
/**
|
|
* Main CCS configuration
|
|
* Located at: ~/.ccs/config.json
|
|
*/
|
|
export interface Config {
|
|
/** Settings-based profiles (GLM, Kimi, etc.) */
|
|
profiles: ProfilesConfig;
|
|
/** Per-profile CLI target overrides (legacy mode) */
|
|
profile_targets?: Record<string, TargetType>;
|
|
/** User-defined CLIProxy profile variants (optional) */
|
|
cliproxy?: CLIProxyVariantsConfig;
|
|
/** Legacy continuity inheritance mapping (profile -> source account) */
|
|
continuity_inherit_from_account?: Record<string, string>;
|
|
}
|
|
|
|
/**
|
|
* Environment variables (string-only constraint)
|
|
* CRITICAL: All values MUST be strings (no booleans/objects)
|
|
* Reason: PowerShell crashes on non-string values
|
|
*/
|
|
export type EnvValue = string;
|
|
export type EnvVars = Record<string, EnvValue>;
|
|
|
|
/**
|
|
* Model preset configuration
|
|
* Stores named model mappings for quick switching
|
|
*/
|
|
export interface ModelPreset {
|
|
name: string;
|
|
default: string;
|
|
opus: string;
|
|
sonnet: string;
|
|
haiku: string;
|
|
}
|
|
|
|
/**
|
|
* Claude CLI settings.json structure
|
|
* Located at: ~/.claude/settings.json or profile-specific
|
|
*/
|
|
export interface Settings {
|
|
env?: EnvVars;
|
|
/** Saved model presets for this provider */
|
|
presets?: ModelPreset[];
|
|
[key: string]: unknown; // Allow other settings
|
|
}
|
|
|
|
/**
|
|
* Profile metadata (profiles.json)
|
|
* Located at: ~/.ccs/profiles.json
|
|
*/
|
|
export interface ProfileMetadata {
|
|
type?: string; // Profile type (e.g., 'account')
|
|
created: string; // Creation time
|
|
last_used?: string | null; // Last usage time
|
|
/** Context mode for project workspace data */
|
|
context_mode?: 'isolated' | 'shared';
|
|
/** Context-sharing group when context_mode='shared' */
|
|
context_group?: string;
|
|
/** Shared continuity depth when context_mode='shared' */
|
|
continuity_mode?: 'standard' | 'deeper';
|
|
/** Bare profile: no shared symlinks (commands, skills, agents, settings.json) */
|
|
bare?: boolean;
|
|
}
|
|
|
|
export interface ProfilesRegistry {
|
|
profiles: Record<string, ProfileMetadata>;
|
|
}
|
|
|
|
/**
|
|
* Type guards
|
|
*/
|
|
export function isConfig(obj: unknown): obj is Config {
|
|
return (
|
|
typeof obj === 'object' && obj !== null && 'profiles' in obj && typeof obj.profiles === 'object'
|
|
);
|
|
}
|
|
|
|
export function isSettings(obj: unknown): obj is Settings {
|
|
if (typeof obj !== 'object' || obj === null) return false;
|
|
if (!('env' in obj)) return true; // env is optional
|
|
if (typeof obj.env !== 'object' || obj.env === null) return false;
|
|
// Validate all env values are strings
|
|
return Object.values(obj.env).every((v) => typeof v === 'string');
|
|
}
|