Clue is a Swift library, and a command-line tool that finds symbol references in Swift projects.
Like Xcode, finding references of a symbol with Clue can be fairly straightforward. Unlike Xcode, Clue exposes controls that fine tune its behavior, so that an expert can find the code references they need 100% of the time.
(Hopefully, it isn't hard to become an expert user!)
Read the Getting Started for installation and usage.
Read Advanced User Guide to become an "expert" user.
{
"name": "Clue",
"path": "/usr/src/package",
"targets": [
{
"name": "clue-cli",
"path": "Sources/clue-cli",
"type": "executable",
"c99name": "clue_cli",
"sources": [
"CLI.swift",
"InputValidationError.swift",
"Miscellaneous.swift",
"Output/Finding+FilePaths.swift",
"Output/Finding+JSON.swift",
"Output/Finding+OutputFormat.swift",
"Output/Finding+ReadableOutput.swift",
"Output/Finding+TCSV.swift",
"Output/OutputFormat.swift",
"SymbolKind+Extensions.swift",
"SymbolRole+Extensions.swift",
"main.swift",
"version.swift"
],
"module_type": "SwiftTarget",
"product_memberships": [
"clue-cli"
],
"target_dependencies": [
"Clue"
],
"product_dependencies": [
"ArgumentParser",
"Chalk",
"IsTTY",
"SystemExit"
]
},
{
"name": "ClueTests",
"path": "Tests/ClueTests",
"type": "test",
"c99name": "ClueTests",
"sources": [
"ClueTests.swift",
"SampleProject.swift"
],
"module_type": "SwiftTarget",
"target_dependencies": [
"Clue"
],
"product_dependencies": [
"Pathos"
]
},
{
"name": "Clue",
"path": "Sources/Clue",
"type": "library",
"c99name": "Clue",
"sources": [
"ClueEngine+Failure.swift",
"ClueEngine.swift",
"Finding.swift",
"LibIndexStore.swift",
"ModuleQuery.swift",
"Query.swift",
"ReferenceQuery+Role.swift",
"ReferenceQuery+USR.swift",
"ReferenceQuery.swift",
"StoreInitializationError.swift",
"StoreLocation.swift",
"SymbolKind+Extensions.swift",
"SymbolOccurence+Extensions.swift",
"shell.swift"
],
"module_type": "SwiftTarget",
"product_memberships": [
"clue-cli",
"Clue"
],
"product_dependencies": [
"IndexStoreDB",
"Pathos"
]
}
],
"products": [
{
"name": "clue-cli",
"type": {
"executable": null
},
"targets": [
"clue-cli"
]
},
{
"name": "Clue",
"type": {
"library": [
"automatic"
]
},
"targets": [
"Clue"
]
}
],
"platforms": [
{
"name": "macos",
"version": "10.13"
}
],
"dependencies": [
{
"url": "https://github.com/dduan/swift-system-exit",
"type": "sourceControl",
"identity": "swift-system-exit",
"requirement": {
"range": [
{
"lower_bound": "1.0.0",
"upper_bound": "2.0.0"
}
]
}
},
{
"url": "https://github.com/apple/indexstore-db",
"type": "sourceControl",
"identity": "indexstore-db",
"requirement": {
"revision": [
"swift-5.6-RELEASE"
]
}
},
{
"url": "https://github.com/dduan/Pathos",
"type": "sourceControl",
"identity": "pathos",
"requirement": {
"range": [
{
"lower_bound": "0.4.2",
"upper_bound": "1.0.0"
}
]
}
},
{
"url": "https://github.com/apple/swift-argument-parser",
"type": "sourceControl",
"identity": "swift-argument-parser",
"requirement": {
"range": [
{
"lower_bound": "1.1.1",
"upper_bound": "2.0.0"
}
]
}
},
{
"url": "https://github.com/mxcl/Chalk",
"type": "sourceControl",
"identity": "chalk",
"requirement": {
"range": [
{
"lower_bound": "0.4.0",
"upper_bound": "1.0.0"
}
]
}
},
{
"url": "https://github.com/dduan/IsTTY",
"type": "sourceControl",
"identity": "istty",
"requirement": {
"range": [
{
"lower_bound": "0.1.0",
"upper_bound": "1.0.0"
}
]
}
}
],
"tools_version": "5.5",
"manifest_display_name": "Clue"
}
{
"name": "Clue",
"targets": [
{
"name": "clue-cli",
"type": "executable",
"exclude": [],
"settings": [],
"resources": [],
"dependencies": [
{
"target": [
"Clue",
null
]
},
{
"product": [
"ArgumentParser",
"swift-argument-parser",
null,
null
]
},
{
"product": [
"Chalk",
"Chalk",
null,
null
]
},
{
"product": [
"IsTTY",
"IsTTY",
null,
null
]
},
{
"product": [
"SystemExit",
"swift-system-exit",
null,
null
]
}
],
"packageAccess": false
},
{
"name": "Clue",
"type": "regular",
"exclude": [],
"settings": [],
"resources": [],
"dependencies": [
{
"product": [
"IndexStoreDB",
"indexstore-db",
null,
null
]
},
{
"product": [
"Pathos",
"Pathos",
null,
null
]
}
],
"packageAccess": false
},
{
"name": "ClueTests",
"type": "test",
"exclude": [
"Fixtures"
],
"settings": [],
"resources": [],
"dependencies": [
{
"byName": [
"Clue",
null
]
},
{
"byName": [
"Pathos",
null
]
}
],
"packageAccess": false
}
],
"products": [
{
"name": "clue-cli",
"type": {
"executable": null
},
"targets": [
"clue-cli"
]
},
{
"name": "Clue",
"type": {
"library": [
"automatic"
]
},
"targets": [
"Clue"
]
}
],
"pkgConfig": null,
"platforms": [
{
"options": [],
"version": "10.13",
"platformName": "macos"
}
],
"providers": null,
"packageKind": {
"root": [
"/usr/src/package"
]
},
"dependencies": [
{
"sourceControl": [
{
"identity": "swift-system-exit",
"location": {
"remote": [
{
"urlString": "https://github.com/dduan/swift-system-exit"
}
]
},
"requirement": {
"range": [
{
"lowerBound": "1.0.0",
"upperBound": "2.0.0"
}
]
},
"productFilter": null
}
]
},
{
"sourceControl": [
{
"identity": "indexstore-db",
"location": {
"remote": [
{
"urlString": "https://github.com/apple/indexstore-db"
}
]
},
"requirement": {
"revision": [
"swift-5.6-RELEASE"
]
},
"productFilter": null
}
]
},
{
"sourceControl": [
{
"identity": "pathos",
"location": {
"remote": [
{
"urlString": "https://github.com/dduan/Pathos"
}
]
},
"requirement": {
"range": [
{
"lowerBound": "0.4.2",
"upperBound": "1.0.0"
}
]
},
"productFilter": null
}
]
},
{
"sourceControl": [
{
"identity": "swift-argument-parser",
"location": {
"remote": [
{
"urlString": "https://github.com/apple/swift-argument-parser"
}
]
},
"requirement": {
"range": [
{
"lowerBound": "1.1.1",
"upperBound": "2.0.0"
}
]
},
"productFilter": null
}
]
},
{
"sourceControl": [
{
"identity": "chalk",
"location": {
"remote": [
{
"urlString": "https://github.com/mxcl/Chalk"
}
]
},
"requirement": {
"range": [
{
"lowerBound": "0.4.0",
"upperBound": "1.0.0"
}
]
},
"productFilter": null
}
]
},
{
"sourceControl": [
{
"identity": "istty",
"location": {
"remote": [
{
"urlString": "https://github.com/dduan/IsTTY"
}
]
},
"requirement": {
"range": [
{
"lowerBound": "0.1.0",
"upperBound": "1.0.0"
}
]
},
"productFilter": null
}
]
}
],
"toolsVersion": {
"_version": "5.5.0"
},
"cLanguageStandard": null,
"cxxLanguageStandard": null,
"swiftLanguageVersions": null
}
{
"url": "/usr/src/package",
"name": "Clue",
"path": "/usr/src/package",
"version": "unspecified",
"identity": "package",
"dependencies": [
{
"url": "https://github.com/dduan/swift-system-exit",
"name": "swift-system-exit",
"path": "/usr/src/package/.build/checkouts/swift-system-exit",
"version": "1.0.0",
"identity": "swift-system-exit",
"dependencies": []
},
{
"url": "https://github.com/apple/indexstore-db",
"name": "IndexStoreDB",
"path": "/usr/src/package/.build/checkouts/indexstore-db",
"version": "unspecified",
"identity": "indexstore-db",
"dependencies": []
},
{
"url": "https://github.com/dduan/Pathos",
"name": "Pathos",
"path": "/usr/src/package/.build/checkouts/Pathos",
"version": "0.4.2",
"identity": "pathos",
"dependencies": []
},
{
"url": "https://github.com/apple/swift-argument-parser",
"name": "swift-argument-parser",
"path": "/usr/src/package/.build/checkouts/swift-argument-parser",
"version": "1.1.3",
"identity": "swift-argument-parser",
"dependencies": []
},
{
"url": "https://github.com/mxcl/Chalk",
"name": "Chalk",
"path": "/usr/src/package/.build/checkouts/Chalk",
"version": "0.5.0",
"identity": "chalk",
"dependencies": []
},
{
"url": "https://github.com/dduan/IsTTY",
"name": "IsTTY",
"path": "/usr/src/package/.build/checkouts/IsTTY",
"version": "0.1.0",
"identity": "istty",
"dependencies": []
}
]
}